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(57) Abstract 

A method and system for Imaging data between two or more digital computers across a computer network is described, where the 
digital computers transfer data in a peer-to-peer mode and/or a cHent/sen'cr mode upon command of the operator. This invention addresses 
the problem of managing, updating and installing executable software, such as operating systems, utilities and application software packages 
on a large number of networked computer systems. By using this invention properly, a system operator can transfer data stored on a single 
computer system to all or some of the computer system connected to the first system over a computer network and can do so without 
expensive electronic server equipment. Moreover, lliis invention provides the capability of transferring data as files, sectors or cylinders of 
disk media, thereby permitting a single operator to, through a generally automated procedure, simultaneously install new system software, 
configuration files and executive files on many computers. This invention provides an important improvement in the operation, maintenance 
and control of large computer networks, although it applies and works equally well in small network applications. In its best mode of 
operation this invention is performed on standard digital computer systems through the use of special purpose computer software. 
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Background of the Invention 

Field of the Invention. 

This invention relates to the systems and methods for copying or mirroring the 
binary data on one computer hard disk drive over a computer network to one or many 
other computer hard disk drives. More specifically, this invention provides a process or 
method for installing and/or distributing software from one computer system to one or 
more other computer systems over a computer network. Furthermore, this invention 
provides a system for solving the often tedious problems of installing computer software 
and distributing computer system files to a number of computer systems, providing a 
mechanism for fast software distribution on networked computers by eliminating the need 
to use the installation utilities of each appUcation program to install the software package 
individually on each computer. 
Description of Related Art. 

It is commonly known in the related art to transfer computer files from one 
computer hard disk to another computer hard disk. Similarly, it is well known to transfer 
files from computer to computer over a computer network. Likewise, computer network 
vendors have created tool sets, for use in their own labs, to transfer data from a master 
computer disk drive to an image file on a file server and then to download the data to the 
target or sla\ e computers. Other existing tools will use the file server to broadcast data 
from an image file to the target or slave computers simultaneously (in parallel). 
Examples of these tools have been disclosed at conferences and with customers by 
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Novell, Inc. 

This invention has substantial and important advantages over prior known 
approaches. This invention not only can use a chent/server model, it can also use a peer- 
to-peer model not available with computer network vendor tool sets or prior used disk-to- 
disk copying. Unlike, prior approaches, this invention can be used without a network file 
server and still can copy computer data from one computer hard disk to many computer 
hard disks over a computer network, by using the peer-to-peer mode of operation. 
Moreover, the peer-to-peer mode of operation provides important advantages in terms of 
transfer speed and lower cost. The speed advantage is realized by using a one step 
process rather than the two step process required for the client/server model of operation. 
In the invention's peer-lo-peer mode, the data is distributed from the master computer to 
the slave computers in a single step. The cost advantage is achieved by not requiring a 
network file server to accomplish the one to many data imaging. Network file servers are 
costly to purchase, install and maintain. 

For general background art the reader is directed to United States Patent Nos. 
4,866,664, 4,872,006, 5,249,290, 5,325,527, 5,396,613, 5,421,009, 5,438,671, 5,452,459, 
5,459,837, 5,461,721, 5,465,351, 5,491,694, 5,495,611, 5,506,902, 5,513,126, 5,513,314, 
5,515,508, 5,515,510, 5,517,645, 5,517,668, 5,522,041, 5,526,490, 5,528,757, 5,537,533, 
5,537,585, 5,542,046 each of which is hereby incorporated by reference in its entirety for 
the material disclosed therein. 

U.S. Patent No. 4,866,664 discloses an interprocessor message communication 
synchronization apparatus and method for a plurality of processors connected to a system 
bus where one processor desiring to send a control signal to another processor, broadcasts 
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an input/outpul write instruction on the system bus along with the address of the receiving 
processor and a data field representative of the control signal to be transmitted. 

U.S. Patent No. 4,872,006 discloses a data transmission system in which data are 
transmitted among plural stations. 

U.S. Patent No. 5,249,290 discloses a method of and apparatus for operating a 
client/server computer network to access shared server resources in response to service 
requests from client computers connected to the network, 

U.S. Patent No. 5,325,527 discloses a client/server communication system 
utilizing a self-generating nodal network wherein the method includes the steps of 
creating a server nodal network tree which includes the steps of generating a server root 
node which includes both process steps for conmiunicating to an operating system and 
service nodes, and process steps for building service nodes which correspond to servers 
within the client/server system, each service node include both process steps for 
advertising a service to the server root node and process steps for building a topic node 
which includes both process steps for accessing a server and process steps for building a 
job node for storing a job request. 

U.S. Patent No. 5,396,613 discloses a method for error recovery in chent/server 
distributed processing systems using cascaded servers. 

U.S. Patent No. 5,421,009 discloses a method for remote installation of software 
over a computer network, allowing the user to interactively select each remote computer 
system for software installation, or to provide a file containing a list of all remote 
computer systems. 

U.S. Patent No. 5,438,671 discloses a two-computer system and method where 
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data is transferred between the computers as complete disk images rather than as files. 

U.S. Patent No. 5,452,459 discloses a method and apparatus for allocating server 
access in a distributed computing environment using a scheduling process. 

U.S. Patent No. 5,459.837 discloses a method and system for monitoring the 
performance of servers across a network and for suggesting an appropriate server to a 
client requesting a service, wherein a plurality of probes are placed in various clients in 
the network by a Broker-Performance Mechanism. 

U.S. Patent No, 5,461,721 discloses a system for transferring data between 
input/output devices and main or expanded storage under dynamic control of independent 
indirect address words. 

U.S. Patent No. 5,465,351 discloses a method and system for memory 
management of a client/server computing network. 

U.S. Patent No. 5,491,694 discloses an apparatus and method for establishing 
"virtual connections" through a packet switched data conmiunications network, the 
network including a plurality of end systems and switches connected by links, to allocate 
a shared resource among competing devices. 

U.S. Patent No. 5,495,61 1 discloses a method and apparatus for dynamically 
loading an ABIOS device support layer in a computer system. 

U.S. Patent No. 5,506,902 discloses a data broadcasting system for the low-cost 
delivery of character-heavy data such as newspapers and magazines. 

U.S. Patent No. 5,513,126 discloses a method for a sender to automatically 
distribute information to a receiver on a network using devices and communication 
channels defined in the receiver profiles. 
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U.S. Patent No. 5,513,314 discloses a fault tolerant NFS server system and 
mirroring protocol for the retrieval of data files including a client system connected to a 
data communication network. 

U.S. Patent No. 5,515,508 discloses a object-oriented client/server facility (CSF) 
and networking service facility (NSF) interfacing between application programs residing 
in client and server nodes of a distributed services network. 

U.S. Patent No. 5,515,510 discloses a conmiunications intemetworfc system 
connecting a client node array to a resource array. 

U.S. Patent No. 5,517,645 discloses a method and system for managing the 
connection of client components to an interface implemented by a sever component 

U.S. Patent No. 5,517,668 discloses a distributed computing system having a 
distributed protocol stack. 

U.S. Patent No. 5,522,041 discloses a data processor and a data transfer method 
for efficiently transferring data between a plurality of information processing devices as in 
a client server system. 

U.S. Patent No. 5,526,490 discloses a data transfer control unit using a control 
circuit to achieve high speed data transfer. 

U.S. Patent No. 5,528,757 discloses a conmiunication network system in which a 
plurality of information processing equipments aie connected with a conmiunication hne 
for communication of a message. 

U.S. Patent No. 5,537,533 discloses a system for remote mirroring of digital data 
from a primar>' network server to a remote network server, which includes a primary data 
transfer unit and a remote data transfer unit which are connected one with another by a 
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conventional communication link. 

U.S. Patent No. 5,537,585 discloses a data storage management system for 
networked interconnected processors, including a local area network and a storage server. 

U.S. Patent No. 5,542,046 discloses a peer to peer connection authorizer which 
includes a system authorizer mechanism, a client connection manager, and a server 
connection manager. 

None of these prior related art references discloses a system for imaging (or 
mirroring) binary data from one computer hard disk drive over a computer network to one 
or many other computer hard disk drives either through a client/server mode or a peer-to- 
peer mode, to provide a mechanism or process for rapid software distribution on 
networked computers which eliminates the necessity of using each application's install 
utility individually on each computer. 

Summary of the Invention 

It is desirable to provide a method and system for installing computer software 
and computer data files on more dian one computer simultaneously, over a network, 
where the method can function upon user command either under a client/server model or 
a peer-to-peer model of operation. 

Accordingly, it is the primary object of this invention to provide a process for 
installing computer appUcation programs on multiple computer systems simultaneously 
over a computer network. 

It is a further object of this invention to provide a process for mirroring data files 
on multiple computer systems simultaneously over a computer network. 

It is further object of diis invention to provide a method for copying binar}' 
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computer data from one computer hard disk drive to one or more other computer hard 
disk drives, which does not require the use of a computer file server. 

It is a further object of this invention to provide a system for mirroring computer 
data from one computer disk drive to another computer disk drive in a peer-to-peer 
coriiputer communications model. 

It is a further object of this invention to provide a system for mirroring computer 
data from one computer disk drive to another computer disk drive in a client/server 
computer communications model. 

It is a further object of this invention to provide a method for mirroring computer 
data between one computer disk drive to another computer disk drive that permits the user 
to select between a client/server and peer-to-peer computer communications. 

It is a further object of this invention to provide a method and system for 
mirroring computer data from disk drive to disk drive that improves the cost performance 
of client/ser\^er systems available in the art. 

It is a further object of this invention to provide a computer data mirroring system 
that incorporates data compression. 

It is a further object of this invention to provide a computer data imaging system 
that has the capabihty of imaging a single disk partition, multiple disk partitions, or the 
entire hard disk, from one computer hai d disk to one or more other computer hard disks 
simultaneously. 

Additional objects, features and advantages of this invention will become apparent 
to persons of ordinarj' skill in the art upon reading the remainder of the specification and 
upon referring to the attached figures. 
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These objects are achieved by a set of two computer programs, referred to by the 
inventor as EVIGBLSTR and IMGSLAVE. The IMGBLSTR program is the primary 
control program while the IMGSLAVE program is used for listening for data from the 
IMGBLSTR program across the network and writing such data to the local disk drive. 

The IMGBLSTR program operates in five modes of operation. These are: 

1 . IMGBLSTR reads the data from the disk drive of the master computer, 
compresses the data, and writes it (uploads it) to an "image file" resident on a 
network file server. This is the client/server model or mode of operation. 

2. In connection with performing mode 1 above, IMGBLSTR broadcasts 
(simultaneously sends in parallel) the data that is being uploaded to the image file 
on the network to all computers running the IMGSLAVE program. This mode of 
operation is a combination of client/server and peer-to-peer. 

3. IMGBLSTR reads the data from the local computer disk drive and broadcasts it on 
the wire (network) to computers running the IMGSLAVE program. The 
IMGBLSTR program does not upload the data to an image file on a network file 
server, rather the data goes directly to the slave computers running ihe 
IMGSLAVE program. This is the peer-to-peer mode of operation. 

4. IMGBLSTR reads the data from an image file located on a network file server, 
decompresses it, and writes ii to its own local computer hard disk drive. This the 
download process for the clientyserver model. 

5. While performing operation mode 4 above, IMGBLSTR broadcasts the data thai is 
being downloaded from the image file on the network to all computers running the 
IMGSLAVE program. This is a combination client/server and peer-to-peer mode. 
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II 



16 



21 



The IMGBLSTR program determines which mode to use through either a series of 
menu options presented to the operator, or through commands from the operator entered 
on the command line when the program is launched. 

The IMGSLAVE program operates in only one mode of operation. Specifically, it 
opens a conmiunication socket on the network, listens for data received on that socket, 
and then processes the data received on the socket. Each packet of data received on the 
socket contains a command field which tells IMGSLAVE what the data contained in the 
packet is used for and how the data is to be processed. The commands in the command 
field are: 

Performed bv 
Master 



Command 
Drive Geometry 



RSVP 



Conform Download 



Slave 



Master 



Sector Data 
Sector Data & Flush 

Skip Track 

Resend Request 



Master 
Master 

Master 

Slave 



Function 

Compare geometry of master 
image with slave 
Response to master to indicate 
participation in download 
Acknowledgment that slave has 
joined the process and that master 
knows slave is ready 
Write data to receive buffer 
Write data to receive buffer and 
flush data to disk 
No data in current track - Skip 
this track 

Slave missed data - Please resend 
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End of Data 



Master 



Master is finished sending data - 



Ready for a slave request 



Done 



Master 



Image complete - Exit program 



Disconnect 



Slave 



Slave response to master "done' 



comjuand - Slave disconnecting 



Disconnect Acknowledge Master 



Master acknowledges slave 



disconnect 



Current source code for both the IMGBLSTR and the IMGSLA VE programs are 
included and listed in the source code section of the detailed description of the invention. 



Figure 1 depicts a system diagram of a computer network having a source (master) 
computer and a number of destination (slave) computers connected to each other 
electronically. 

Figure 2 depicts a system diagram of a computer network using the prior approaches 
utilizing client/server modes of operation for transferring data from one computer to other 
computers across a network. 

Figure 3 depicts the top level state diagram of the master computer ("IMGBLSTR") 
program / process component of the invention. 

Figure 4 depicts the top level state diagram of the slave computer ("IMGSLAVE") 
program / process component of the invention. 

Figure 5 depicts the top level process flow chart of the master computer component of 
the invention. 

Figure 6 depicts the detailed flow diagram of the process menus steps of the master 



Brief Description of the Drawings 
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computer component of the invention. 

Figure 7 depicts the detailed flow diagram of the upload image step of the master 
computer component of the invention. 

Figure 8 depicts further detail of the read head step of the upload image section of the 
master computer component of the invention. 

Figure 9 depicts further detail of the broadcast head step of the upload image section 
of the master computer component of the invention. 

Figure 10 depicts further detail of the download image step of the master computer 
component of the invention. 

Figure 1 1 depicts further detail of the fill compress buffer from file step of the down 
load image step of the master computer component of the invention. 

Figure 12 depicts further detail of the get byte from compress buffer step of the down 
load image step of the master computer component of the invention. 

Figure 13 depicts further detail of the write data to head buffer step of the down load 
image step of the master computer component of the invention. 

Figure 14 depicts further detail of the flush head buffer step of the write data to head 
buffer step of the master computer component of the invention. 

Figure 15 depicts a flow chart diagram of the slave component of the invention, which 
is a detailed flow diagram of the current prefeired embodiment of the Slave computer process 
of the invention. 

Detailed Description of the Invention 

Figure 1 shows a computer network having a source (master) computer 101 and a 
number of destination (slave) computers 102a, 102b. 102c, 102d, 102e, 102n connected to 
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each other electronically as may be used in the peer-to-peer mode of operaUon of the 
invention. A typical stand-alone computer may include the following components: a 
processor; internal memory; a disk storage device; a display device; and an input device. 
The electrical connection 103 provides a communication channel between the computer 
systems. The use of this invention does not require that the connection between the computer 
systems, as designated 103, necessarily be electrical. Other alternative methods of 
conductivity include, fiber optical, RF, and/or light wave transmission and detection. Often 
these types of communications channels are referred to as "networks/' "local-area-nelworks" 
(LANs), and '*wide-area-networks" (WANs). Typically, each computer is capable of 
operating as a stand-alone system. With the addition of the electrical connection 103 the 
computers are also capable of sharing information (for example data files and e-mail). The 
applicants' present invention extends the capabilities of individual computer systems 
connected over a computer network by providing disk imaging from one computer to another 
computer over a network. Such disk imaging provides a solution to the problem of installing, 
backing up, maintaining, and upgrading of computer operating system software, computer 
system utility software, and application programs. This invention, which operates either with 
or wiUiout a computer network server, permits a single computer system to be designated as a 
"master" and to transfer data from its disk drive or drives to one, some or all of the other 
computers on the network, designated as "slaves." 

Figure 2 depicts a system diagram of a computer network employing the traditional 
network server hardware 201. This system is well known for providing a method of 
transferring data to and from the network server and from and to the individual computers on 
the network. These prior approaches, typically are referred to as "client-server" systems. In a 
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traditional client-server system, data is transferred from a client computer 202 to the network 
server 201, or is transferred from the server 201 to one or more of the client computers. 
While applicants' invention supports client-server network systems, the most important 
achievement of this invenUon is that it provides the capability of transferring data, files, and 
disk sectors from any computer on the network to any other computer on the network with or 
without a network server, thereby dramatically decreasing the difficulty and complexity of 
computer network management. Where a network server 201 is employed in the network the 
"master" computer 202a is provided with the capability of transferring data either to the 

network server 201 and/or to one or all of the *'slave" computers 202b, 202c, 202d, 202e 

202n. This inventions supports networks utilizing client/server modes of operation for 
compatibility with existing networks. It also supports and provides peer-to-peer operation to 
permit networic management without the considerable expense of networic server hardware 
and simultaneously providing a significant improvement in data transfer efficiency across a 
computer network. 

In its best mode of operation, the present invention operates through coordinated use 
of two computer system communications programs: IMGBLSTR and IMGSLAVE. 
IMGBLSTR is designed to operate on the "master" computer, while IMGSLAVE is designed 
to operate on the "slave" computer. ]n the current preferred embodiment of the invention 
each program is written in the C programming language and operates on a DOS operating 
system. However, other equivalent embodiments of the invention may be created in other 
computer languages, including but not limited to C++, Pascal, and assembly code, and may 
be designed to operate on other computer operating systems, including but not limited to 
UNIX, Windows and MacLitosh. The following discussion of the steps of the process of this 
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invention correspond to programs, sub-programs, and routines in IMGBLSTR and 
IMGSLAVE best mode of the invention. Following this discussion of the essential steps of 
this process is a complete list of the source code for each program. This source code is 
provided as part of this disclosure, to provide a fully enabUng description of the invention. It 
is suggested diat the reader refer to this source code for additional detailed description as the 
reader reviev^s the following figure by figure discussion of die process of the invention. 

The following description of the top level state diagrams of the "master" computer 
and the "slave" computer is provided to give the reader an overview of the handshaking and 
data processing process of the invention. A detailed breakdown of each subprocess, task or 
program is given in die later detailed descriptions of the process flow charts and the best 
mode of operation of the invention is provided in die listing of software source code included 
in this description following the description of the detailed subprocesses, tasks, and/or 
programs. 

Figure 3 depicts the top level state diagram of die master computer ("IMGBLSTR") 
program / process component of the invention. The master computer process begins by 
entering the Wail for Slave Connection state 301 . In this slate 301 the master computer is 
initialized for communication with slave computers. The process goes from state 301 to state 
302 when the master computer broadcasts its disk drive geometr>' to the slave computers. In 
this Send Geometry Packet state 302 the master computer sends the master computer drive 
geometry to slave computers on die send IPX socket. The "currently connected clients" 
display is initialized. Geometry packets are sent periodically to the slave computers. 
Geometry packets, in the preferred embodiment of the invention, include the following disk 
drive information for the master local disk drive: maximum cylinders; maximum heads; 
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1 maximum sectors, image file partition start cylinder; and image file partition end cylinder. 
Geometry packets also include information on the IPX network sockets, including: the 
network address; the node address; and the socket number. Error conditions are monitored 
and the master computer waits for RSVP packets from the slaves. When the master computer 
receives an RSVP from the slave the master adds the slave (or client) to its hst and send an 
6 ACK packet to the slave 303. When the connection between the master and one or more 
slaves is either completed, terminated by an operator conrunand, or terminated by a timeout, 
the master process goes to the Send Data Mode state 304. The Send Data Mode state 304, in 
combination with the Send Head Broadcast state 306 and the Loop to Send All Tracks state 
305, performs the upload image, broadcast head, broadcast skip head, broadcast given head, 

1 1 and the send IPX packet tasks. In the event that a Resend Request is received the process 
goes from the Send Data Mode state 304 to the Queue Req. On Resend List - Perform 
Throttle Processing 307. During this state, incoming packets are processed, resend requests 
are processed by servicing the resend queue by sending data packets to slaves, resend requests 
are recorded, the resend list is processed and tracks are re-transmitted. These tasks are 

16 processed in conjunction with state 306. In the event that no more data remains to be sent, 
the process moves to the Allow Slaves to Catch-Up state 308. This state finishes processing 
of broadcasts and handles late resend requests. The transition of the process from stale 308 to 
state 309 is accomplished as follows: (1) a timer indicates it is time to send a packet; (2) a 
packet of data is sent 309; and (3) the process returns automatically to state 308 to wait for 

21 the next timer indication. Thus, when the timer has run, the process moves from the Allow 
Slaves to Catch-Up state 308 to Send "End of Data" Packet state 309, which sends farewell 
broadcast packets, and back to state 308. When the transfer is complete (when a timeout 
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occurs), the process moves to the Farewell to Slaves state 310, which in combination with the 
Send "Goodbye" Broadcast state 312 and the Remove Slave From List Send "Goodbye" to 
Specific Slave state 311, performing the say Goodbye to Slaves and Processing Image 
Packets tasks. 

Figure 4 depicts the lop level state diagram of the slave computer ("IMGSLAVE") 
program / process component of the invention. Beginning with the Hook-Up with Master 
state 401 the slave computer attempts to form a communications link with the master 
computer. After a geometry packet is received from the master, the slave process moves to 
the Send RS VP state 402, where the slave checks the disk drive geometry for compatibility 
and acknowledges receipt of the geometry information with an RS VP. After the slave 
process receives a RSVP acknowledge from the master, the process enters the Download 
Data state 404, Data is received via transitioning between the Download Data state 404 and 
the Process Data Packet state 407. The Process Data Packet state 407 processes the received 
data by checking to see if the head is at a valid position, and storing the received data in a 
buffer. A test is performed to determine if the designated slot is not empty, wherein a "lost 
data" resend request is sent. The process of the invention provides the capability of sending 
resend requests through the Send Resend Request state 408. If a "flush" packet is received (a 
"flush" packet is a special type of data packet, containing an attribute to indicate that when 
the data is copied to the image file, that the image file should then be flushed to disk), the 
Flush Complete Track stale 405 is entered, where if the buffer is complete, it is written to 
disk and the *'good upto" track is updated, removing the track from the "missing list." If the 
buffer is incomplete, this stale 405 sends a "lost data" resend request and adds the track to the 
"missing list." When the transfer of data is complete, a "End of Data" packet is received 
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from the master, leading the slave process to the Farewell to Master state 409, where once a 
"goodbye" is received from the master, the Random Delay - Send "Goodbye" to Master state 
410 is entered to send a "goodbye" is send to the master. Thereby, finishing the slave 
process. 

Figure 5 depicts the top level, process flow chart of the master computer component of 
the invention. In its current best mode of operation, the process of this invention begins with 
the initialization 501 of the master. During this initialization step 501 the user license is 
verified, usage parameters are checked the MAC address of the computer is acquired and 
displayed, the local drive geometry is retrieved, all needed buffers are allocated, and the 
number of hard disk drives installed in the computer is determined. Next, the command line 
process step is performed 502, where the conunand hne is parsed, setting flags and/or calling 
the functions to process each command. Next, menus are processed 503. The process menu 
step calls other functions to get needed information for the execution of the program. A test 
is made as to whether the process is required to upload data ("image") to a slave or download 
data ("image") 504. If the process is required to upload data then the upload image step 505 
is performed to upload the image, drive data, to the image file. If the process is not required 
to upload data then the download image step 506 is performed, which accomplishes the 
downloading of the image (drive data). If a file name was specified by the operator, it is 
opened and the drive data is read from the file. Lastly, the clean-up step 507 is performed to 
reset all affected computer systems on the network. 

Figure 6 depicts the detailed flow diagram of the process menus steps of the master 
computer component of the invention. The process menus program process calls other 
program and/or functions to get the needed information for the process of the invention. 
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Where the requested information has already been entered on the command line, the 
associated menu is not displayed. First, the program variables are initialized 601. Next, the 
desired process function is requested 601, allowing the operator to specify whether the 
operator wants to upload or download. Next, the get partition 603 step is performed to 
display the local drive partition table and to allow the operator to specify the partition to be 
imaged. The next step is to get the image file name 604, during which the operator is 
prompted to provide the name of the image file, including the complete path. Next, the 
broadcast state is requested 605, that is, whether the operator wants to send the drive data to 
other slave computers via broadcast packets. 

Figure 7 depicts the detailed flow diagram of the upload image step of the master 
computer component of the invention. The upload image program process performs the 
function of uploading the image (drive data) from a master computer to a network server 
computer and/or, if the broadcast feature is enabled, broadcasting the data to the image slave 
computers on the network. Initially, upload image program is initialized 701 . This 
initialization step is necessary to provide needed data. A test 712 is made to determine 
whether the invention is operating in the chent/ser\xr mode. If it is, an image file is opened 
702 and an image header is written 703. The drive head buffer is read 704. A test is 
performed to determine whether the data is to be broadcast 705 to multiple slave computers. 
If the data is to be broadcast the broadcast is performed 707, if not the process passes through 
the null state 706 before once again testing to determine if the process is in the client/server 
mode 713. If it is, the data is compressed and written to a file 708. Data compression is 
accomplished, currently by a *'Run-Length Encoding" scheme well known in the art. Next, 
System pointers are incremented 709 and if the system has not reached the stop cylinder 710 
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the process continues to read the head buffer 704, broadcasts the data 707, compresses the 
data, and adjusts the system pointers. After the stop cylinder is reached 710, the process 
performs the clean-up step 71 1 by closing files, resending missed tracks and saying 
"goodbye" to slave (client) computers. 

Figure 8 depicts further detail of the read head step of the upload image section of the 
master computer component of the invention. This program step reads a head worth of data 
from a selected local hard disk drive at the current cylinder and current head location. Errors 
that are encountered, are reported. The process of the invention is aborted after five retries on 
errors. However, because CRC type errors are recoverable, they will not count towards 
aborting the process. First, this sub-process is initialized 801, providing access to the 
necessary variables. Next, the data in the designated current head is read 802. If a read error 
occurs 803 the read of head data is attempted again, up to five times 805. If errors continue 
beyond five tries 805 an error message is displayed 806 and the program is exited 807. 
Otherwise, if the data is read without error then the process passes through the null state 804 
and the program returns to the upload image process step 505 as shown in figure seven. 

Figure 9 depicts further detail of the broadcast head step of the upload image section 
of the master computer component of the invention. The function of the broadcast head 
program - subprocess is to broadcast the drive head data (headbuffer) to the image slaves 
using the send IPX socket. Data is sent 512 b>tes at a time, equal to a single sector of disk 
data. On the last sector sent, the command to flush the data, that is, to write it to the hard 
drive, is sent. The first step in the broadcast head process is to initialize the data for 
broadcast 901 . The process of sending packets of data 905 is performed one sector at a time. 
After it is determined that an additional sector of data is in the head 902, the sector data is 
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packaged 905 or prepared for broadcast, a delay is provided 903 to insure correct interpacket 
data broadcast, then the packet is sent 905. The broadcast head process is finished when no 
further sectors remain for transfer. 

Figure 10 depicts further detail of the download image step of the master computer 
component of the invention. This program sub-process of the invention performs the 
function of downloading the image (disk drive data). If a file name is specified by the 
operator, it is opened and the disk drive data is read from the file. If the broadcast feature is 
enabled, the data is broadcast to the image slaves on the network. The first step is to initialize 

1001 the needed data and to set the head buffer pointer to 0. Next, an image file is opened 

1002 if needed and if the image file name is valid. The image header data is read 1003 and a 
check is made for the proper drive geomeuy. If the image geometry is equal to the drive 
geometry 1004 then the data is decompressed 1006 using well known "Run-Length" 
decompressions schemes. Once the data is decompressed it is written 1007 to the head 
buffers. After data is written to the head buffer, this part of the process is complete. If the 
image geometry does not match the drive geomeUy, of step 1004, an error message 1005 is 
displayed. 

Figure 1 1 depicts further detail of the fill compress buffer from file step of the down 
load image step of the master computer component of the invention. This function fills the 
compress buffer by reading a head size (maximum sectors times 512) of data from the image 
file. If an error occurs during the read, an error message is displayed. First, the data is 
initialized 1 101 to provide data for the process. Next, the compress buffer file size is read 
1 102 and tested 1 103 for error. If an error is encountered, it is displayed 1 105, otherwise a 
null state 1 104 is used and the process returns to the download image process of the invention 
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of figure 10. 

Figure 12 depicts further detail of the gel byte from compress buffer step of the down 
load image step of the master computer component of the invention. This process 
subprogram functions to retrieve a byte from the compress buffer. When the compress buffer 
is empty, it is refilled by reading data from the image file. First, the data is initialized 1201 
for use in the process. Next the compress pointer is tested 1202 to determine if it is greater 
than the size of the compress buffer. If it is, the compress buffer is filled 1203 from the 
image file. The compress pointer is then reset 1204, The byte pointed to by the 
pointer/counter is returned 1206 and the process returns to the download image process of 
figure 10. hi the event that the compress pointer does not exceed the size of a buffer, test step 
1202, the process goes through a null state 1205 and returns 1206 the byte pointed to by the 
compress pointer and returns to the download image process. 

Figure 13 depicts further detail of the write data to had buffer step of the down load 
image step of the master computer component of the invention. This step functions to take 
the byte of data passed to it and write it to the head buffer the number of times indicated by 
the compress counter. This is part of the process of decompressing the image file. When the 
head buffer is full, it flushes the data to the hard disk drive. First, the data required is 
initialized 1301. Next, the data is written into the head buffer 1302. The head buffer pointer 
is incremented 1303. A test 1304 is made to determine whether the head buffer is full. If it 
is, the head buffer is flushed to disk 1305 and the pointers/counters are adjusted 1306. A test 
1308 is then made to determine whether the compress count is complete. If it is, the process 
returns to the download image of figure 10. If it is not, then the process returns to step 1302 
to move a byte into the head buffer. If the head buffer, of step 1304, is not full, a null stale 
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1307 is passed through before the compress count test of step 1308. 

Figure 14 depicts further detail of the flush head buffer step of the write data to head 
buffer step of the master computer component of the invention. This step functions to flush 
the head buffer data to disk. The entire head buffer is written in one command. All needed 
pointers, counters, etc., are updated along with screen information. Also, if the broadcast 
feature is enabled, the head data is broadcast to the image slaves. First the data is initialized 
1401 for use in this process. Next, a test 1402 is made to determine if the process is in the 
broadcast mode. If it is, the head data is broadcast 1403 to all image slave computers. If not, 
the process goes through a null state 1404. The head buffer is then written 1405 to disk and 
the current head and cylinder data is adjusted 1406 prior to returning to the write data to head 
buffer process of figure 13. 

Figure 15 depicts a flow chart diagram of the slave component of the invention, 
is a detailed flow diagram of the current preferred embodiment of the Slave computer process 
of the invention. The IMGSLAVE is the slave component or process of the invention that 
provides the parallel disk image process. The slave uses an IPX socket to listen for data from 
the image master. A special header in the data from the master determines the function the 
slave will perform. The IMGSLAVE program cannot create or restore an image without the 
IMGBLSTR program. Its function is to listen to the network for data from the IMGBLSTR, 
to reuieve data from the network and to write it to the slave's local drive. The slave process 
begins by initializing 1501 data for processing. When a geomeuy packet is received 1502 
from the master the slave responds with an RSVP 1503. Next, the slave listens for an RSVP 
acknowledge 1504 from the master. After the receipt of the RSVP acknowledge, a test 1505 
is made to determine whether the register for download is valid, if not, a message indicating 
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that the transfer is unusable is sent 1506. Alternatively, if the register for download is valid, 
then the data is downloaded 1507 to the slave. Error checking 1508 is performed and errors 
are displayed 1509 if detected. If no errors are detected, a download complete message is 
displayed 1510. 

The following is a listing of the computer source code which is the current best mode 
preferred embodiment of the invention. The reader can, by consulting this source code, learn 
all that is necessary to produce and use the invention. 



Software Source Code 
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#define KEY_ENABLE_DEBUG 1 /* Causes the '@' key lo toggle DebugBroadcast mode. */ 
//#define IGNORE.ORIGINAL.GEOMETRY I /* Tums on a Debug mode used lo test 
geometry independence. */ 
#undef IGNORE_ORlGINAL^GEOMETRY 

* (C) Copyright 1996-1997 KcyUbs, Inc. 

* All Rights Reserved. 

* This program is an unpublished copyrighted work which is proprietary 

* to KcyLabs, Inc. and contains confidential information that is not 
10 * to be reproduced or disclosed to any other person or entity without 

* prior written consent from KeyLabs. Inc. in each and every instance. 

* WARNING: Unauthorized reproduction of this program as well as 

* unauthorized preparation of derivative works based upon the 

* program or disuribution of copies by sale, rental, lease or 

15 * lending are violations of federal copyright laws and stale u^e 

* secrei laws, punishable by civil and criminal penalties. 

Program: IMGBLSTR.C 

20 Description: This program is the master component of the parallel disk image process. This 

master uses an IPX socket lo send 

data to the image slave. A special header in this data determines the function the slave will perform. 
An IPX socket is also used to receive requests from the slave (ie. re-send sector data). 
There are five modes of operation for the master: 
25 1 - Create Image on network server. 

2 - Send image data lo slave while doing #1 . 

3 - Send image data !o slave without doing #1. 

4 - Download image from network server. 

5 - Send image data to slave while doing #4. 
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Author: Kevin J. Turpin Dale: 13 May 1996 
Mod 1: Added drive preparation option to write to all unused portions 

of a partition prior to uploading. Kevin - Oct 16, 1996 

Mod 2: Added debug processing to display counters during upload. 
5 Kevin - Oct 29, 1 996 (See DisplaySlalicScreenData and 

WriteDataToCompressBuffer functions) 

#incJude <stdio.h> 

#include <stdlib.h> 
10 #include <siddef.h> 

#include <stdarg.h> 

#include <conio.h> 

#include <dos.h> 

#include <dir.h> 
15 #include <al1oc.h> 

#include <bios.h> 

#include <iime.h> 

#include <string.h> 

#inc]ude <mem.h> 
20 ^include <process.h> 

^include <io.h> 

#include <fcntl.h> 

#include <sys\siat.h> 

#inc!ude <ciype.h> 
25 #define NWDOS 

#include <nwipxspx.h> 

#include "largemsg.h" 

#include "freespc.h" 

#include "csr.h" 
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#include "imgslave.h" 
#include "eval.h" 
#include "license.h" 

5 z***********************************************************^ 

// The next #derine's are for controlling how the program works for 
// debug, normal. If the #define DEBUG is uncommenled, Various debug 
// messages will be displayed during execution. 
//#defme DEBUG 1 
10 // end of special #define's 

I* Make sure this program has plenty of stack space 
* (the default is something like 4K). 
*/ 

1 5 unsigned _stkJen = 1 6384; 

/* Space for the License information: */ 

#include "crypchar.h" /* Get CRYPT...{) macros and decrypt_pnnistring() proto. */ 
#define DISTRIB_BY_STR1NG \ 
20 CRYPT_16( 'D', 's\ 'i\ T, 'b*, 'u\ \\ 'e', 'd'. * 'b*, y, V, ' ') 
char distributedByf] = { 

DISTRIB_BY_STRING. 

CRYPT^40( 'K', 'e', y, 'L', 'a', 'b', 's\ \\ * T, \ 
'n', 'c\ • \ • \ • \ • \ \ 

25 

.................... 

0 /* NUL-ierminaior. */ 

); 
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/******#*#********«**«»*************#«****************^^ 

#define TRUE 1 
#define FALSE 0 
#define WRITE 3 
5 #define READ 2 
#define EXIT 0 
#defme STD^DATA I 
#define FLUSH 2 
#define GEOMETRY 3 
10 #define ENDOFHLE OxFF 
#dcfine HD_DRIVE 0x80 
#define COMPRESSIONKEY OxD5 



#define FILLDATA OxFE 
#definc IPXOPENSOCKETERR -1 

15 #define ALLOCERR -2 

#define BIOSERR -3 

#define SECTORERR .4 
#define BADGEOMETRY 5 

#derine HLEOPENERR -6 

20 #define READERR >7 

#defme VERIFYERR -8 

#define SENDPACKETERR -9 

#define WRITEERR -10 

^define CLOSEERR -11 

25 #define LICENSEERR -12 

#derine NEEDHLENAMEERR -13 



^define MAX_STATIC_SCREEN_DATA 29 
#define MAX^DYNAMIC_SCREEN_DATA 18 
#derme LOCALMAC 0 
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#define 


IMAGEHLE 


1 


#define 


LOCALCYL 


2 


#defjne 


LOCALHEAD 


3 


#derine 


LOCALSECT 


4 


#dcfine 


MASTERCYL 


5 


#define 


MASTERHEAD6 


#derine 


MASTERSECT 7 


^define 


PROCCYL 


8 


#dcfine 


PROCHEAD 


9 


#dcfmc 


PROCSECT 


10 


^define 


SENDSOCKET 1 1 


#define 


RECVSOCKET 12 


#define 


STOPCYL 


13 


^define 


STOPHEAD 


14 


#define 


STOPSECT 


15 


#define 


HEADSSENT 


16 


#define 


HEADSMISSED17 



If. TYPES 

lypedef struct clienl { 
20 struct client *prev; 

siruct client *ncxl; /* Doubly-linked list pointers. */ 

BYTE nelAddressf 12]; /* Client's IPX address. */ 
/* Add other stuff here (e.g. throttling stuff) */ 

) Clientlnfo; 

25 //- DECLARATIONS 

#include '*prog_id.h" 

static unsigned int ProgramlD = IMAGEBLASTERJD; /* From prog^id.h */ 
static unsigned int ProgramMajorVersion = 1 ; 
static unsigned int ProgramMinorVersion = 4; 



wo 98/50874 PCTAJS98/09018 

30 

static unsigned int ProgramRevision = 11; 

static int evalProgram = 0; /* Set when only license is eval. */ 

sialic ini licenses = 0;/* Return value from licenseCount() used to determine 

* whether or not broacast stuff is enabled, and to 
5 * make sure users don't try to add more clients 

* than those for which the master is licensed. 
*/ 

#definc BROADCAST.ENABUEDO ( licenses > 1 ) 
#denneNUMBER_ECBs 20 
10 ECB recciveECB[ NUMBER.ECBs]; 

IPXHeader receiveHeader[ NUMBER^ECBs]; 

BYTE lPXDaiaBuffer[ NUMBER.ECBs]! 512 + sizeoRBufferPacketHeader)); 
ClienUnfo *cliems = NULL; 

int curreniClientCount = 0; 
15 int expeciedClientCount = -1 ; 

WORD LocalSocket; /* Our dynamically-bound local socket. */ 
ECB ReceiveECB, 

SendECB; 
IPXHeader SendHeader, 
20 ReceiveHeader; 

BYTE NeiAddress|12], 

IPXSendBuffer[512+22], 

lPXRecvBuffer[512+22]; 
int i. 
25 value, 

HeadCompJete = TRUE, 

ImageGeometryFound = FALSE, 

UpIoadFlag = FALSE. 

DownioadPlag = FALSE. 
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AutomaiionFlag = FALSE. 
CommandLineFlag = FALSE, 
ImagcFileNameFlag = FALSE, 
ImageFileNameValid = FALSE, 
5 BroadcastEnableFlag = FALSE, 

NoBroadcastEnableFlag = FALSE, 
ValidDaialnHcad = FALSE, 
ReadAfierWriteVerifyFlag = FALSE. 
DebugFlag = FALSE. 
10 DebugBroadcasi = FALSE, 

DebugBroadcastDisplayMACs = FALSE, 
MonitorBroadcastDelays = FALSE. 
Force WriteDala = FALSE; 
ini PrepareDriveFlag = FALSE; 
1 5 char PrepareDri veLeller;/* Set when PrepareDriveFlag is set to TRUE. */ 
ini NTRag = FALSE; /* Running on NT, so avoid physical disk calls. */ 
ini LocalMaxHeads, 

LocalMaxCylinders, 
LocalMaxSeclors, 
20 LastSentSector = 0, 

PartiiionNumber = -1, 
ImageFiieHandle, 
DelayValue =0, 
// DelayValue = 1. 
25 FlushDelay = 0. 

// FlushDelay = 0. 
CurrentCylinder, 
CuneniHead, 
CurreniSector = 1, 
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ValidUpThruCylindcr = -1, 



ValidUpThruHead = -l, 



CompressCount = 1 , 



NumberOfHardDrives = 1 , 



5 



CurreniHardDrive = 1 , 



CurrentHDDrive = HD_DRIVE, 
HardDriveID[4] = {TRUE, FALSE. FALSE, FALSE); 
unsigned long lotalHeadsSent = OL; 
unsigned long totalHeadsMissed = OL; 
10 #define SPEEDUP^INTERVAL_SECONDS ( 20) 

#der)ne NEXT_SPEEDUP()( clock() + ( SPEEDUP_INTERVAL„SECONDS * CLK.TCK)) 
docket limeForNextSpeedup = OL; 
enum { 



15 ) Phase = BLAST; 

#define WINDOW.SIZE 50 

#derine SLOWDOWN^THRESHOLD 5 

unsigned ini windowSamples[ WINDOW^SIZE]; 

int windowSloi = 0; 
20 long numberSamplesThis Window = OL; 

typedef struct { 



BLAST, CLEANUP 



int 



consecuti veDataLosses ; 



long 



headsSent; 



long 



headsMissed; 



25 



) PerDelayCoums; 



#define NUM^DELAYS ( 100) 



PerDelayCoums perDe)ayCounts[ NUM_DELAYS]; 



PerDelayCoums oulOfRangeCounls; 



/ 
\ 
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unsigned long precisionDelayLoopsPerSecond;/* For precise timing loops, 
♦(kind of like Linux BogoMips 

* and jiffies). 



*/ 



int xcord, ycord; 
5 long CompressPTR = 0, 

ByteslnCompressBuffer, 
HeadBufferPTR = 0; 
Jong FiIlTimes=0; 
long CKCount=l, 
10 FDCount=l; 

char ErrorMessage[80], 
TmpBuffer[20], 
ImageFileNaine[80], 
FillData[4096]; 
15 unsigned char * HeadBuffer, 

* ConnpareHeadBuffer» 

* CompressBuffer, 
LaslData, 
Current, 

20 ImageDataByte, 

TempBuffer[512). 
PartitionBuffer[512]; 
BufferPackctHeader OurHeader; 
struct ImgFileHeadcr 
25 { 

// int headerKey; 
im maxHeads; 
im maxCylinders; 
im max Sectors; 



// for compression algorithm 



// Counters for Debug purposes 



// for compression algorithm 
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// long maxSeciors; 

im panilionSlarlCylinder; 

int paniiionEndCylinder; 

int comprcssionKey; 
5 int parti lionNumber; 

unsigned char rawParlilionBuffcr[512]; 
// char imageFileName[80]; 
) ImageFileHeader; 
siruci PartiiionTable 
10 { 

im stanCyiinder; 
int endCylindcr; 
#if defined( lGNORE_ORIGINAL_GEOMETRY) 
int startHead; 
15 int endHead; 

#endif 

int booiFlag; 

int type; 

long loialSeciors; 
20 } Panition[5]; // 5ih entry is entire drive 

struct DynamicScreenType 
I 

im x; 
im y; 

25 ) DynaniicScreenDalafM AX_DYNAMIC_SCREEN_D ATA] = { { 24 ,9 ) ,// Local MAC addr 



1 52. 9), 
{ 24, 13), 
{24,14). 



//Image file 
//Local Cyl 
//Local Head 
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I 24, 15), //Local Sector 
{64.13), //Image Cy) 

{64,14}, //Image Head 
{ 64. 15), //Image Sector 
{ 29,22-1). //ProcCyl 
{40.22-1). //Prochead 
{ 49,22-1). //Proc sector 
{ 2,22.1). //Send socket 
{ 8,22-1). //Recv socket 
( 29.23-1), //Stop cylinder 
{ 40.23.1). //Stop Head 
{ 49, 23-1), //Stop Sector 
{ 64+7, 22-1),// Heads Sent 
{ 64+7. 23-1)// Heads missed 

}; 

struct StaticScreenType 
{ 

int broadcaslRelated; 
inc x; 
int y; 

char* Text; 

) StaticScreenData[MAX_STATIC^SCREEN_DATA]=| {0,33.1. "I M G M A S T R"}. 

{0.5,9, "Local MAC Address:"), 
{0.40.9: "Image File:"), 
{ 0, 1 0, 11 /Local Drive Geometry" ) , 
(0,50,1 1, "Image Drive Geometry"), 

(0,10,12,"-" - --'•), 

{0,50.12. " "), 

{0,13.13. "Cylinders"), 
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{0,53.13. "Cylinders"), 
{0,13.14, "Heads"), 
{0,53,14, "Heads"), 
{0.13,15, "Sectors"), 
{0.53,15, "Sectors"), 
{0,34,18-1, "Processing"). 

{0,34,19-1." 

{0,27,20-1, "Cylinder"), 

{0.27,21-1." "), 

{0.39,20-1, "Head"), 
{0,39,2M. ".—"), 
{0.47.20-1, "Sector"), 

{0.47,21-1." 

{1,4,18.1, "Sockets"), . 

{1.4.19-1," "), 

{1.2,20-1. "Send Recv"), 

{1.2,21-1," "). 

{1.64 + 7.20-1," Heads"). 

(1,64 + 7.21-1/' "), 

{1,64,22-1, " Sem:"}. 
{1,64,23-1, "Missed:") 

); 

// Function Declarations 

void Initiaiize( void); 

void GetDriveGeometry( void); 

void ParseConmiandLine(int argc, char * argv[]); 

void ProcessSwitch(char * switchString); 

void ProcessMenus( void); 

void FunclionMcnu( void); 
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void PanitioriMenu( void); 

void lmageFi!eNameMenu( void); 

void BroadcastMenu( void); 

//void SocketNumberMenuO; 
5 void ReadPartitionTable( void); 

void Processlmage( void); 

void UploadIniage( void); 

void InitializeForBroadcastC void); 

void DisplayProcessingScreen( void); 
10 void BroadcastDriveGeometry( void); 

void SendOurIPXPacket( void); 

void SendOurIPXPackelSized( int dataSize); 

void ReadDriveHead(unsigned char * buffer); 

void BroadcastHead( void); 
15 int CompressHead( void); 

int WriteDaiaToCompressBuffer( void); 

int FIushCompressBuffer( void); 

void DownloadImage( void); 

unsigned char GeiByleFromCon)pressBuffer( void); 
20 void FiIlCompressBufferFromFile( void); 

void WritcDalaToHeadBuffer{int compressCount, unsigned char data); 

void FlushHeadBuffer( void); 

void WrileHcadBufferToDrive( void); 

void CheckGeomeiry( void); 
25 void Beep( void); 

void Display Usage( void); 

void DisplayBiosError(inl ccode, int x, int y); 

void LogError(ini errCode, char * errMessage); 

void DisplaySlaticScrecnData( void); 
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void CleanExit( void); 

void Disp!ayLocalGeometry( void); 

void DisplaylmageGeometry{ void); 

void DisplayProcDaia( void); 
5 void DisplayLocalMAQ void); 

void DisplaySockelNumbers( void); 

void PrcpareDriveWorker{ char driveChar); 

void PrepareDrive( void); 

void DrawBarGraph(int PercentCompleled); 
10 void WrileEvalMessage( void); 

void DeiermineNumberOfHardDrives( void); 

void AllocaleBuffers( void); 

void DealIocaieBuffers( void); 

void finishBroadcasiProccssing( void); 
15 void handleLateRescndRequcsts{ void); 

void sayGoodbyeToClients( void); 

/* This"TexlColor()interface should be used instead of lextcolor() since 
* it returns the previous color, allowing code to RESTORE the color 
20 ♦ to what it was before the change. 
*/ 

static int currentTextColor = LIGHTGRAY; 
int 

Texi_Color( int newCoIor) 
25 { 

int oldColor = currentTextColor; 

textco]or( newColor); 
currentTextColor = newColor; 
return oidColor; 
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) 

/* Catch uses of textcolor() from now on-should be using 

* Text_Color() instead. 
*/ 

5 #define textcolor( a) HOSERMAMA_USE_Text_Color_INSTEAD_of Jextcolor( a) 

/* Inform at ihe top of the screen in a "rolling log window" 

* fashion. 

* Probably only called by DB_INFORM() and TEST_INFORM(). 
10 * 

*/ 

void 

_INFORM( char *fmt. va.Iist ap) 
I 

15 static inl line =1; 

ini X = wherexO. y = whcreyO; 

int originalColor = Tcxt_Color( LIGHTGRAY); 

gotoxy( l,line); 

clreoK); 

20 vprinif( fmt, ap); 

clreolO; /* Clear to end of "current" line. */ 

line++; 

if(linc>7) { 

line = I ; 

25 ) 

goioxy( 1, line); 

clreoK); /* Clear NEXT line. */ 

goioxy( X, y); /* Restore original cursor. */ 

Text_Color( originalColor); 
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) 

/* "Debug Broadcast" inform. Display the message ONLY IF the 
* DebugBroadcasi flag is set. 
5 */ 
void 

DB JNFORM( char *fmt, ...) 
{ 

if ( DebugBroadcasi) { 
10 vajislap; 

va_sian( ap, fmi); 
_INFORM( fml, ap); 
va_end( ap); 

) 

15 ) 

/* Test inform. Display the message. 
*/ 

void 

20 TESTJNFORM( char *fml, ...) 
{ 

va_iist ap; 
va_stan( ap, fmi); 
_INFORM( fmt, ap); 
25 va_end( ap); 

) 

void 



TopLargeMsg{ ini clearScreenFlag, char *msg) 
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int X = wherexO; 
int y = whereyO; 
goioxy( 1,1); 

5 DisplayLargeMsg( clcarScrecnFlag, msg); 

goioxy( X, y); 

) 

void 

10 inform( FILE *stream, char *lml, ...) 
{ 

va_lisi ap; 
va_stan( ap, fmt); 
vfprintf( siream. fmt, ap); 
15 va_cnd( ap); 

) 

void 

ca!culaiePrecisionDelay( void) 
20 { 

/* These are volatile to try to gel the compiler to NOT 

* optimize access to them, either by placing the variables 

* in registers or by completely optimizing-away references 

* to the variables. 
25 */ 

volatile cIock_t end; 

volatile clock_t now; 

volatile unsigned long loops = 0; 

DB_INFORM( "Calculating precision delay..."); 
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/* Wail for lick edge */ 

end = clockQ; 
while ( clockO == end) 
5 I) 

/* Count one second. */ 
end = clockO + CLK^TCK; 
while ( 1) { 
10 now = ClockO; 

if ( now > end) 
break; 

Ioops++; 

) 

15 precisionDelayLoopsPerSecond = loops; 

DB_INFORM( "precisionDelayLoopsPerSecond is %)u\n", loops); 
if { DebugBroadcast) { 

end = ClockO + CLK_TCK; 
/* Pause so the numbers can be read. */ 
20 while ( clock() < end) 

{} 

) 

) 

25 void 

lenihMilliDelayl unsigned im lenlhMilliscconds) 
{ 

/* These are volatile to try to gel the compiler to NOT 
* opiiinize access to them, either by placing the variables 
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* in registers or by completely optimizing-away references 

* to the variables. 
*/ 

volatile clock_i end; /* DUMMY. */ 
volatile unsigned long loops = 0; 
volatile unsigned long loop_limii: 
if ( lemhMilliseconds = 0) /* Short circuit. */ 

return; 

/* Calculate how many "loops" we need for the required delay. */ 
loopjimit = ( (unsigned long)tenthMiIliseconds 

* precisionDelayLoopsPerSecond . 

/lOOOOL); 

/* If we're running on a machine that is SO SLOW that it can't 

* accurately meter out a small enough delay, jusl RETURN. 

* (The processor is so slow that the multiply/divide calculation 

* above probably took long enough. :-) 
*/ 

if ( loopjimit == 0) { 
return; 

) 

/*This loop is coded in a somewhat strange manner in an attempt to 

* get the code path to match, as closely as possible, the delay- 

* calculation loop in calculatePrecisionDelay(). 
*/ 

while ( I) { 

end = clockQ; /* DUMMY, to match timing loop in calcPrecisionDelay... */ 
if ( loops > loop^limil) 
break; 

loops++; 
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/* Display the current flush and inlerpacket delay values, but only 

5 * if the DebugBroadcast or MonitorBroadcaslDelays variables are set. 
* 

*/ 

void 

showDclayValues( void) 
10 { 

static im labelsDone = 0; 

if ( DebugBroadcast il MonitorBroadcaslDelays) { 
im X = whcrexO; 
im y = whereyO; 

^ 5 im originaJColor = Texl_CoIor(UGHTGRAY); 

if (! labelsDone) { 

goloxy( 55, 17); 
cprimfC Flush Delay:"); 
goioxy( 55, 18); 
20 cprintfC'Inler Delay (+/-):"); 

) 

Text^Color( WHITE); 
gotoxyC 73,17); 
cprimf("%4d", FlushDelay); 
25 goioxy(73, 18); 

cprinlf("%4d", DelayValue); 
gotoxy( X, y); 
if ( ! labelsDone) { 

labelsDone++; 
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) 

Text_Color( original Color); 

) 

} 

void 

dispIayTotalAndMissedHeads( void) 
( 

if ( 0 == ( lotalHeadsSeni % 10)) { 
10 im X = wherexQ; 

ini y = whereyO; 

int originaiColor = Texi_Color( WHITE); 
gotoxy( DynainicScreenDatal HEADSSENTJ.x, 
DynamicScreenDataf HEADSSENTJ.y); 
1 5 cprintf{"%61u", lolalHeadsSent); 

gotoxy( DynamicScreenData[ HEADSMISSEDJ.x, 

DynamicScreenDala[HEADSMlSSED].y); 
cprintf("%61u", loialHeadsMissed); 
Text_Color( originaiColor); 
20 goioxy{ X, y); 

) 

) 

/* Routines lo compare one track to another. */ 
25 int 

CHEqual( long cyll, long head! , 

long cyl2. long head2) 

{ 

return (cyll == cyl2 &&. head! == head2); 
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) 

im 

CHlessThan( long cyll , long headl , 

long cyl2» long head2) 

{ 

return ( (cyll <cyl2) 

II ( cyni==cyl2 
&& headl <head2)); 

) 

// stari of program 

int 

main{inl argc, char * argv[]) 
{ 

/* Get license count before processing command-line 

* options-some options are enabled or disabled 

* based on the license count. 

licenses = licenseCount( NULL, ProgramID, ProgramMajorVersion); 
// check usage parameters, display USAGE if needed, 
if ((argc == 2) && 

((strcmpi(argv[l], "?") == 0) II 

(strcmpj(argv[l], "/?") == 0))) { 

DisplayUsageO; 

CleanExilO; 

1 

// Parse the command line 
ParseCommandLine(argc, argv); 
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/* VERIFY license count after parsing command-line 

* opiions-this allows us lo do things like display 

* the usage message and license info even though 

* the program isn't licensed. 
*/ 

if ( licenses == 0) { 

printfC'This program is not licensed.Xn"); 
exit( 1); 



// Calculate number of precision loops per millisecond 
//of delay 

calculatePrecisionDelayO; 

if ( isEvaILicense( ProgramlD, ProgramMajorVersion)) { 

evalualion„notice{); /* from conimon/client/eval/eval.c */ 
55 evalProgram = 1 ; 

) 

if ( PrepareDrivcFlag = TRUE) { 

/* User selected command-line option to prepare drive. 

* So Prep the drive and then exit. 

2^ * Note that we do this BEFORE the call lo InitializeO 

* so wc can avoid the physical disk I/O associated with 

* getting drive geometry (this physical I/O is issued 

* in InitializeO). 
*/ 

25 PrepareDriveWorker( PrepareDriveLetter); 

CleanExitQ; 

) 

// Initialize the needed info for the program 
InitializeO; 
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// Process the menus for data noi on command line 
ProcessMenusO; 

// Now process the image (either upload or download) 
ProcessImageO; 
5 return 0; 

) 

Program: Initialize 

Description: This function initializes the data for the program.lt 
10 does the following: 

1 - Gets the local MAC address 

2 - Gels the local drive geometry 

3 - Allocates the buffers 
Author: Kevin J. Turpin Date: 13 May 1996 

15 Modifications: 

Mod #1-Added call to DetennineNumberOfHardDrives.Kevin-Oct 30,1996 
Mod #2 - Added check for debug mode. Kevin - Nov. 2. 1996 

void Initialize( void) 
20 { 

// Are we in debug mode as per compile time? 
#ifdef DEBUG 

DebugFiag = TRUE; 

#endif 

25 // Get the MAC address of this machine and display it 

IPXInitializeO: 

I PXGeil niernei workAddress(Nel Address); 
// Gel local drive geometry 
GeiDriveGeometryO; 
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// Allocate all needed buffers 
AllocaleBuffersO; 

// Now that the buffers are allocated, lets determine how 
// many hard drives are in this computer. 
5 DetermineNumberOfHardDrivesO; 

// Lei's read the local partition table 
ReadPanitionTableO; 

) 

10 Program: GetDriveGeometry 

Description: This function determines the local drive geometry by 
reading the data from the drive partition table. 
Author: Kevin J. Turpin Date: 6 May 1996 

15 void GelDriveGeomctry( void) 
{ 

int ccode; 

ccode=biosdisk(8, CurrentHDDrive, 0. 1. 1, 1 , TempBuffer); 
if (ccode) { 

20 sprinif(ErrorMessage, "\n\nBios error %x reading drive geometry.", ccode); 

LogError(BIOSERR. ErrorMessage); 
CleanExitO; 

} 

LocalMaxCylinders = TempBuffer[l] + ((TempBuffer[0]»6) « 8); 
25 LocalMaxSectors = TempBuffertO] & Ox3f; 

LocalMaxHeads = TempBuffer[3]; 
// Show Geometry if in debug mode 
if(DebugFlag == TRUE) { 
clrscrO; 
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prinif("\nHeads = %d", LocalMaxHeads); 

printf("\nCylinders = %&\ LocalMaxCylinders); 
printf("\nSectors = %&\ LocalMaxSectors); 

printf("\n\nPress any key to continue "); 

geichO; 

) 

) 

Program: ParseConnmandLine 

Description: This function parses the conunand line, setting flags 

and/or calling the functions to process each command. 
See DispIayUsageO for a list and description of the 
documented command-line switches. See ProcessSwitch() 
for information on UNDOCUMENTED switches. 

Author: Kevin J. Turpin Date; 13 May 1996 

void ParseConmiandLine(int argc, char * argv[]) 
{ 

im i; 

char impBuf[80]; 
for (i=0; i<argc; i++) { 

// Parse the switches 

sucpyCtmpBuf, argv[i]); 

if (tmpBuf[0] == '-*) { // we have a switch 

ProcessSwitch(tmpBuO: 

) 

} 

) 
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Program: ProcessSwitch 

Description: This function process the switch siring. 

See DisplayUsageO for a list of documented command-line 
switches. 

The UNDOCUMENTED switches are: 

-db Turns on "debug broadcast" mode 

-db! Turns on "debug broadcast" mode AND displays MAC 

addresses of clients that request retransmissions. 
-M Turns on "monitor broadcast" mode. This mode shows 
the delay values but does not print the othermessages. 
-Z ! Turns on DebugFlag (debug mode). 
-F Turns on ForceWriteData mode. 
Author: Kevin J. Turpin Date: 13 May 1996 
Mod #1 - Added debug switch key "!". Kevin - Nov. 2. 1996 
Mod #2-Added the "R" switch for read after write verify.Kevin 12-17-96 
Mod #3 - Added the "db" (debug broadcast) switch. Chris 12-27-1996. 

void ProcessSwilch(char * switchSuing) 
{ 

/* First check for multi-character switches. */ 

/* NB: The "-db" switch is NOT documented in the 'usage' message. */ 

if ( stricmp( "-db", swiichString) = 0) { 

DebugBroadcast = TRUE; 

return; 

) 

/* Check for "verbose" debug nnode, in which we display the MAC 
* addresses of clients that request retransmissions. 
*/ 

if ( stricmp( "-db!". switchString) == 0) { 
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DebugBroadcasi = TRUE; 
DebugBroadcastDisplayMACs = TRUE; 
relurn; 

) 

/* None matched, so check for single-character switches. */ 
switch(toupper(switchString[l))) { 

case 'U': /AJpload function 

UpIoadFIag = TRUE; 

break; 

case 'D': //Download funciion or debug 

DownloadFlag = TRUE; 

break; 

case *P': //Partition number 

PartiiionNumbcr = atoi(&switchStringI2)) - 1 ; 
break; 

case 'I': //Image file name 

strcpydmageFileName, &switchStringI2]); 
ImageFileNameFIag = TRUE; 
if ( strlen( ImageFileName) > 0) ( 

ImageFileNameValid = TRUE; 

) 

break; 

case 'R': //Read after write verify 

ReadAflerWrileVerifyFlag = TRUE; 
break; 

case *B': //Broadcast enabler 

if ( BROADCAST_ENABLED()) ( 

BroadcaslEnableFlag = TRUE; 

if ( isdigit( switchSlring[ 2])) { 
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int param; 

if (sscanf(&swiichSiring[2],"%u",&parain) =:=!){ 
if ( param =:= 0) ( 

/* Switch -bO says DISABLE broadcast. */ 
BroadcasiEnableFIag = FALSE; 
NoBroadcastEnableFlag = TRUE; 

1 

else { 

expecledClientCouni = param; 

) 

} 

else { 

primf("\n\nSwitch '%s' is invalid.", switchSlring); 

CleanExilO; 

} 

) 

) 

else { 

printf("\n\nS witch Vos' is invalid.", switchString); 

CleanExitO; 

) 

break; 
case *L': 

displ ayM y Liccnses() ; 

CleanExitO; 

break; 

case 'G': /* "C'et Ready (prepare drive). */ 
{ 

char driveChar = toupper( swiichSiringf 2]); 
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if ( 'A' <= driveChar && driveChar <= 'Z*) { 
PrepareDriveFlag = TRUE; 
PrepareDriveLelier = driveChar; 
) 

else { 

printf("\n\nlnvalid drive letter.Valid range is *A'..'Z'.\n"); 
QeanExitO; 

} 

) 

break; 

case 'N': /* Option -NT */ 
if ( loupper( switchString[ 2]) == T) { 
NTFlag = TRUE; 

) 

else { 

primf("\n\nS witch -%s is invalid.", &swiichString[l]); 
CleanExilO; 

) 

break; 

^ * 4: 4c 4: * * * * :4c * * 4: * * * * :K 4c * * * * 4: 4: « 4: / 

/* UNDOCUMENTED switches: */ 
case 'M': 

MoniiorBroadcaslDelays = TRUE;// Shows broadcast delays, 
break; 

case *Z*: 

if (switchString[2] == T) //special 
debug flag key 

DebugFlag = TRUE; 

break; 
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case 'F: 

Force WriteDaia = TRUE; 
break; 

default: 

prinlf('*\n\nS witch -%c is invalid.". swiichString[l]); 

CleanExitO; 

break; 

) 
) 

Program: ProcessMenus 

Description: This function calls other functions to gel the needed 

information for the program. If the information has 
already been entered on the command line (indicated by 
flags), the associated menu is not displayed. 

Author: Kevin J. Turpin Date: 13 May 1996 

void ProcessMenus( void) 
I 

if (UploadFlag == FALSE && DownloadFlag = FALSE) 

FunctionMenuO; 
if (PartiiionNumber < 0) 

PartitionMenuO; 
if (ImagcFileNameFlag == FALSE) 

ImageRleNameMenuO; 
if ( BROADCAST.ENABLEDO) { 

if (BroadcastEnablcFlag == FALSE && NoBroadcastEnableFlag ==FALSE) 
BroadcastMenuQ; 

) 
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if ( ImageFileNameValid = FALSE && BroadcastEnableFlag == FALSE) { /* No work to do! 

*/ 

sprinlf(ErrorMessage, "\nNothing lodo"); 
DisplayLargeMsg(l, " Error**); 
LogErTor(FlLEOPENERR. ErrorMessage); 
QeanExitO; 
) 

// if ((SendlPXSockeiNumber = 0 II RecvIPXSockelNumber = 0) && 
// (BroadcastEnableFlag = TRUE)) 

// SockelNumberMenuO; 
) 

Program: FunctionMenu 

Description: This ftinction dipslays the function menu to allow the 
operator to specify whether he wants an upload or download operation. 
Author: Kevin J. Turpin Date: 13 May 1996 

void FunctionMenu( void) 
{ 

char ch; 
do { 

clrscr(); 

DisplayLargeMsg(l, " FUNCTION"); 



prinlf("\n Function Menu"); 

printfCAn \n"); 

printf("\n (U)plDad Image"); 

printf("\n (D)ownload Image\n"); 

printf(*An (P)repare drive for upIoad\n"): 
printfCAn (Q)uii ProgramVn"); 
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printf("\n Enter Function Option [U/D/P/Q]:**); 

// Eval message 

WrileEvalMessageO; 

ch = getchQ; 

if (toupper(ch) == U') 

UploadFlag = TRUE; 
else if (toupper(ch) = 'D') 

DownloadFlag = TRUE; 
else if (loupper(ch) = 'P') 

PrepareDriveO; 
else if {toupper(ch) = •Q*) 

cxit(O); 

else 

Beep(); 

) while (UploadFlag == FALSE && DownloadFlag = FALSE); 
Program: ParlitionMenu 

Descripuon:This function dipslays ihe local drive partition table 

and allows Ihe operator to specify the partition to be 
imaged. 

Author: Kevin J. Turpin Date: 13 May 1996 

void PanilionMenu( void) 
I 

int i, 

number; 
char impChars[2]; 
static const struct SiaticScreenTypell 



wo 98/50874 



PCT/US98/09018 



58 

int x; 
inl y; 
char * lexi; 

) staticScreenDala[15] = { { 33. 9. "Partition Menu"), 

(33. 10. " 

{ 34, 12, "CyUnder"), 
{ 57, 12, "Total" 
{68, 12, "Partition"). 

{7,13, "Partition Active Status Start End Sectors"), 
17.14," - - 

"Bytes Type"). 

{ 54, 14. " ~"). 

{ 11.15.-1"). 
{ 11.16, "2"), 
{ 11, 17. "3"). 
{ 11.18, "4"). 

{11,20, "5 Entire Disk"), 

{ n, 22, "Enter Partition Number fO=Exil] :") }; 

int originalColor = Text_Color( UGHTGRAY); 

ParliiionNumber = -1 ; 
do{ 

clrscr(); 

DisplayLargeMsg(l, " PARTITION"); 
// Now display the static portion 
for (i=0; i<15;i++)( 

gotoxy(siaticScreenDaia[i].x, 

staticScreenDaia[i].y); 
cprinlf("%s", staticScreenDaialiJ.iext); 
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// If there is more than one drive in the system, allow user 
// to switch between drives, 
if (NumberOfHardDrives > 1) | 
gotoxy( 11,21); 

cprinlf("9 Change Drives"); 

Text_Color(WHITE); 

gotoxy(35,ll); 

cprintf('*Drive # %d", CurrenlHardDrive); 

) 

// Now display the dynamic data and gel option 
Texi^Color(WHITE); . 
for (i=0; i<4; i++) { 

if {Parlilion[i].lotalSectors > 0) ( 
gotoxy(18. 15+i); 
if (Partition[i].bootRag == TRUE) 
qjrintfC'Bootable"); 

else 

cprintf( "Nonbootable"); 
goioxy(35, 15+i); 

cprintf("%#3d %#3d %#7Id %#llld",Parlition[i].startCylinder. 
Partition(i].endCylinder, 

Partition(i) .totalSectors, 
Partilion[i].totalSectors*5 1 2); 

// Display partition type 
gotoxy(67, 15+i); 
swiich(Partilion[i].type) { 
case 0x00: 

cprimfC'Unknown"); 

break; 
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case 0x02: 

cprimf("PCIX"); 

break; 
case 0x01: 
case 0x04: 
case 0x06: 
case 0x016: 

cprintf{"DOS, FAT"); 

break; 
case 0x05: 

cprintfC'Exiended"); 

break; 
case 0x07: 

cprinlf("OS/2 HPFS"); 

break; 
case 0x0 A: 

cprinlfC'Boot Manager"); 

break; 

default: 

break; 
) 

) 

) 

// Write Eval onJy copy 
WrileEvalMessageO; 

Text_Color(LIGHTGRAY); // change back to nonnal text 

// Now get the option 
gotoxy(45, 22); 
impCharslO] = getch(); 
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tmpChars(l] = NULL; 
number = atoi(tmpChars); 
if (number = 0) 

CleanExitO; 

5 //if (number =- 9 && NumberOfHardDri ves = 2) (//changedrivconlyif avail, 
if (number = 9) { 
// if (CurrcniHardDrive =!){// currently 1 st drive, make ii 2nd 
// CurremHardDrive = 2; 

CurrenlHDDri ve = HardDri veID[ lyj/ we found the id earlier 

10 // } 

// else { 

// CurremHardDrive = 1 ; 

// CurrentHDDrive = HardDri velDIO]; 



// 



15 



if (++CurrentHardDrive > 4) 



CurrentHardDrivc = 1 ; 



while (HardDriveID[CurrentHardDrive-l] != TRUE) { 



if (++CuiTentHardDrivc > 4) 



CurremHardDrive = 1; 



20 



CurrenlHDDri ve = 0x80 + CurremHardDrive- 1 ; 



GetDriveGeometryO; 



// get it for the new drive 



ReadPartitionTableO; 



// Wc will need to re-do our buffers due to size changes 



25 



DeallocateBuffersO; 



AllocateBuffersO; 



else if (number > 0 && number < 6) 



if (Partition[number-l].ioialSectors > 0 II number == 5) 
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PartitionNumber = number- 1; 

else 

BeepO; 

) while (PartitionNumber == -1); 

Text^CoJor{originalColor); // change back to nonnal text 

) 

Program: ImageFileNameMenu 

DescriptioniThis function prompts the operator for the name of the 

image file. Name includes complete path. 
Author: Kevin J. Turpin Date: 13 May 1996 

void ImageFileNameMenuC void) 
{ 

clrscrO; 

DisplayLargeMsg(l, " FILENAME"); 

printf("\n Image Filename Menu"); 

printf("\n \n"); 

do{ 

if (DownloadRag == TRUE)// must enter file name if download 
printf("\nEnter image filename (complete path) : '*); 

else 

printf("\nEnter image filename (complete path) [Enter=No filej : "); 
// Write Eval only copy 
WriteEvalMessageO ; 
gels(ImageFileName); 

if (str]en(lmageFileName) > 0 ) { 

ImageFileNameValid = TRUE; 

) 
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if ( UploadFlag == FALSE && ImageFilcName Valid == FALSE) { 
primf("\n" 

"\n" 

"Filename REQUIRED for downJoad.\n" 
"\n"); 

) 

/* We REQUIRE a filename for downloads, */ 
) while ( UploadFlag == FALSE && InnageFileNamc Valid == FALSE); 
) 

Program: BroadcastMenu 

Descriplion:This function determines whether the operator wants to 

send the drive data to other slave computers via 

broadcast packets. 
Author: Kevin J. Turpin Date: 13 May 1996 

void BroadcastMenu( void) 
{ 

cIrscrO; 

Di$playLargeMsg(l, " BROADCAST"); 

printf("\n Broadcast Mode Menu"); 

printf("\n \n"); 

printf("\nThe drive data can be broadcast to other computers running the"); 

printf("\nIMGSLAVE program/'); 

printfCAnDo you want to use this broadcast feature? {Y/N)|N]: "); 

// Write Eval only copy 

WriteEvalMessageO; 

if (toupper(getch()) == 'Y') 

BroadcastEnableFlag = TRUE; 
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else 

BroadcaslEnableFIag = FALSE; 

) 

Program: SocketNumberMenu 

Description: This function allows the operator to enter IPX socket 

numbers for both the send and receive IPX sockets used 
in the broadcast of drive data to the slaves. 

Author: Kevin J. Turpin Date: 13 May 1996 

#ifO 

void SockelNumberMenuO 
{ 

chartmpString[20]; 

printfC*\n\nTwo IPX sockets are used for thebroadcasiingof drivedata."); 
printR'^nYou may specify the socket numbers for these two sockets."); 
printf("\nTo avoidconflict withother applications on the network, the"); 
printf("\nsockei numbers should be between aaaa and bbbb (hex).' ); 
prinlf("\n\nThe sendsockei numbermusl matchthai usedas receive socket"); 
printf("\nnumber by the IMGSLAVE slaves."); 
printf("\n\nEnter the send socket number [1984] : "); 
flushallO; 

// Write Eval only copy 
WrileEvalMessageO; 
gets(tmpString); 
if (strien(tmpString) > 2) 

sscanfdmpSmng, "%x", &SendIPXSocketNumber); 

else 

SendlPXSocketNumber = 0x1984; 
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prinif("\n\nEnier ihe receive socket number [1985] : "); 

gcis(tmpString); 

if (strlen(tmpString) > 2) 

sscanf(lmpString, "%x\ &RecvIPXSocketNumber); 
5 else 

RecvIPXSockeiNumber = 0x1985; 

) 

#endif 

10 Program: ReadParlilionTable 

DescriplioniThis functionread thepanition tableat ihefront of the 

local harddrive and parsesout the information for each 
partition. 

Author: Kevin J. Turpin Date: 13 May 1996 
J5 ****************************************************♦*#***********» 

void ReadPartiiionTab!e( void) 

I 

int ccode, 

PB0ffsel[4] = {446, 462, 478. 494 ) ; 
20 // Read the partiiion table at the start of the drive 

ccode = biosdisk(READ. // read function 

CurrentHDDrive, // on the local drive 

0, //headO 

0, // cylinder 0 
25 1 , // sector 1 

1 . // read 1 sector of data 
PartiiionBuffer); // put it in the Panition buffer 

if (ccode) ( 

sprintf(ErrorMessage, *'\n\nBios error %x reading parti lioniable", ccode); 
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LogError(B10SERR, ErrorMcssage); 

ClcanExitO; 

1 

// Now parse out the partition information 
5 for (i=0; i<4; i++) { 

PartitionliJ.startCylinder = PartiUonBufferIPBOffset[i]+3] + 

((PartitionBuffer[PBOffsel(i]+2]»6)«8); 
Partition[i).endCylindcr = PartitionBufferfPBOffsetnH?] + 

((PartilionBuffer[PBOffset[i]+6]»6)«8); 
1 0 #if derined( IGNORE^ORIGINAL.GEOMETRY) 

Partilion[i].startHcad = PartitionBuffer[PBOffsel(i]+l]; 
ParlilionIi).endHead = PartitionBuffer[PBOffset[i)+5); 
inform! stderr, "Partition %d: stanhead %u, cndHead %u\n", i, 
Partition[ i].stariHead, 
15 Pariition[ i].endHead); 

(void)getch(); 

#endif 

// the sector data is packed 

memmove(&Pariition[i].totalSeclors,&PartitionBuffer[PBOffset[i]+12].4); 
20 Partiiion[i].booiFlag = FALSE; 

if (PartitionBuffer[PBOffset[i]) == 0x80) 

PartitionliJ.booiFlag = TRUE; 
PartitionIi].typc = PartiiionBuffer[PBOffset(i]+4]; 

1 

25 // Partition 5 will be the entire drive 
Parliiion[4].startCyIinder = 0; 
Partition[4].endCylinder = LocalMaxCylindcrs; 
// Save the partition data in raw formal for the image file header 
memmove(lmageFileHeader.rawPanitionBuffcr, Parti tionBuf for. 512); 
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Program: Proccsslmage 

Description: This function is the controlling function for the image process. It determines 
5 whether an upload or download 

should be performed and calls the appropriate function. 
It also governs the cleanup if the broadcast feature 
is used. 

Author: Kevin J. Turpin Date: 14 May 1996 
10 ******************************************»**********«*#*^^ 

void ProcessImage( void) 

{ 

// We need to open some sockets and so forth if broadcast 
if (BroadcaslEnableFlag == TRUE) 
J 5 InitializcForBroadcasiO; 

// Now lets process the image 
if (UpIoadFiag ==TRUE) 
Upload! mage(); 

else 

20 DownloadlmageO; 
) 

Program: Uploadlmage 

Description: This function performs the uploading of the image 
25 (drive data). If a filename was specified by the operator, 

il is opened and the drive data is written to the file. 

If the broadcast feature is enabled, the dala is broadcasted 
to the image slaves on the network. 
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Author: Kevin J. Turpin Date: 14 May 1996 

void Up!oadlmagc( void) 
( 

5 // initialize needed data 

// Open the image file if needed and write the image header. 

ImageFileHeader.headerKey = Oxaa; 
ImageFileHeader.maxHeads = LocalMaxHeads; 
ImageFileHeader.maxCylinders = LocalMaxCylinders; 
1 0 ImageFileHeader.maxSectors = LocalMaxSectors; 

ImageFileHeader.parlilionNumber = P^r(ilionNumber+ 1 ; //make ] -5 
ImageFileHeader.partitionStartCylinder = 

Partiiion[PanitionNumber].startCylinder; 
lmageFileHeader.partitionEndCylinder = 
^ 5 Partition[PartilionNumber].endCylinder; 
ImagcFileHeader.comprcssionKey = Oxd5; 

sircpy(ImageFiIeHeader.imageFjleName, ImageFileName); 
if (ImageFileNameValid == TRUE) { 

if ((ImageFileHandle = open(lmageFileName, 

2^ 0_WRONLYIO^CREATIO_BINARYIO„TRUNC. 

S J WRITE)) ==-1) { 
sprintf(ErrorMessage, "VnError opening image file %s'\ 

ImageFileName); 
Display LargeMsg( 1, " Error"); 
25 LogError(F!LEOPENERR, ErrorMessage); 

CleanExitO; 
) 

if ( wriiedmagePileHandle, &ImageFileHeader, 
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sizeoRlmageFileHeader)) 
!= sizeof( ImageFileHeader)) { 
sprintf(ErrorMessage, *'\nError writing image file %s'\ ImageFileName); 
DisplayLargeMsg(l, " Error"); 
5 LogError(WRITEERR, ErrorMessage); 

CleanExitO; 
) 

) 

// If broadcast enabled, lets pause and let operator start process 
1 0 if (BroadcasiEnableFlag = TRUE){ 

Display LargeMsg( 1, " PAUSING"); 
WriteEvalMessageQ; 

printf("\n\nPress any key to start the upload and broadcast 
process...'*); 

^ 5 BroadcastDri veGeomeu^O;// so slaves can determine if image fits 

) 

// Now process the desired part of the drive. 
DisplayProcessingScreenO; 

for (CurrenlCylinder = Parti lion |PartitionNumber).startCyIinder; 
20 CurrenlCylinder <= Partition[PartitionNumber].endCyiinder; 

CurrenlCylinder++) { 
#if denned( IGNORE^ORIGINAL_GEOMETRY) 

for (CurrenlHead = ( ( CurrenlCylinder = PartitionI PartitionNumber].startCylinder) 
? Partiiion[ PariitionNumber].startHead 
25 : 0); 

#else 

for (CurrenlHead = 0; 

#endif 

CurrenlHead <= LocalMaxHeads; 
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CuiTeniHead++) { 

DisplayProcDalaO; // display where we are 

ReadDriveHead(HeadBuffer); // read this head 
/* Update "valid up to" numbers. */ 
5 ValidUpThruCylinder = CunenlCylinder; 

ValidUpThniHead = CurrentHead; 
if ( CompressHeadO) { // compress what we can 

sprinlf(ErrorMessage, "\nError writing image file %s", 
ImageFileName); 
10 DisplayLargeMsg( 1 , " Error"); 

LogError(WRITEERR, ErrorMessage); 

ClcanExiiO; 

) 

if (BroadcastEnableFlag == TRUE) { 
15 BroadcaslHeadO; 

ValidDatalnHead = FALSE; 

} 

if ( BroadcastEnableFlag != TRUE) { 
if{kbhii()) { 

20 if (ioupper(geich()) == 'Q') 

CleanExitO; 

} 

) 
) 

25 ) 

#if 0 /* Code nK>ved to finishBroadcastProcessingO, which is 
* called below. 
*/ 

// If in broadcast mode, send exit command 
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if (BroadcaslEnableFlag == TRUE) { 
OurHeader.command = EXIT; 

for (i=0; i<3; // multiple times so were sure ihey get it 

SendOurlPXPacketO; 

5 ) 
#endif 

if (CompressCouni > 0) {// If we were compressing before 
if ( FlushComprcssBufferO) I // move it to the CompressBuffer 
/* ERROR writing to disk. */ 
^0 sprinif(ErrorMessage, "\nError flushing buffer to image file %s'\ 

ImageFileName); 
DisplayLargeMsg( 1 , " Error'*); 
LogError(WRITEERR. ErrorMessage); 
CleanExilO; 
J5 ) 
) 

// Close the image file if used 
if (ImageFileName Valid == TRUE) { 
if ( closeOmageFileHandle)) { 
20 sprintf(ErrorMessage. "XnError closing image file %s", 

ImageFileName); 
DisplayLargeMsg( 1 , " Error"); 
LogErTor(CLOSEERR. ErrorMessage); 
CleanExitO; 
15 ] 

] 

if ( BroadcaslEnableFlag) { 

finishBroadcaslProcessingO; /* Resend any missed tracks, then 
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* say "goodbye" lo the clients. 
*/ 



5 /************************************************************** 
Program: InitializeForBroadcast 

Description: This function prepares for the broadcasting of data. 

It initializes IPX and opens the send and receive IPX 
sockets. 

10 Author: Kevin J. Turpin Date: 14 May 1996 

void lniliali2eForBroadcast( void) 
{ 

/* Open Sockets */ 
1 5 LocalSocket = 0; /* Request DYNAMIC socket. */ 

if (IPXOpenSockei((BYTE far *)&LocalSocket, 0) != 0) { 

sprinif(ErrorMcssage, "\n\nError opening dynamic local socket!"); 

LogErrordPXOPENSOCKETERR, ErrorMessage); 

CleanExitO; 

20 } 

DB_INF0R^4( •'Opened DYNAMIC socket Ox%x\n", SWAP_WORD( LocalSocket)); 

/* Initialize "completed ECBs" list. */ 
initEsrQueueO; 

25 /* Initialize and Post a bunch of receive ECBs */ 

for (i=0; i<NUMBER^ECBs; i++) { 

receiveECB(i].ESR Address = ESRHandler; 
receiveECB[i].socketNumber = LocalSocket; 
receiveECB[i],fragmentCounl = 2; 
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receiveECB[i].fragmcniDescriptor[0].address = 
&receiveHeader[i]; 

rece!veECB[i].fragmenlDescriptorIO].size = 
sizeof(IPXHeader); 

receiveECB(iJ.fragnieniDescripior[l ].address = 
IPXDataBuffer[iJ; 

receiveECB[i].fragmentDescriptor(l].size = 512 + sizeoR 

BufferPackciHeader); 

IPXListenForPackct( &receiveECB[ i]); 

1 
) 

/* Cancel any pending IPX listens. */ 
void 

ShutdownBroadcast( void) 
{ 

int i; 

/* CANCEL any pending listens. */ 
for (i=0; i<NUMBER_ECBs; i++) { 

if ( receivcECBf i].inUseFlag) ( 

if ( IPXCancelEvenK &receiveECB[ i])) { 

inform( siderr, "\nFailed to cancel IPX Iisten.\n"); 

) 

) 

) 

) 



Program: DisplayProcessingScreen 

Description; This function displays the static portion of the 
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processing screen; 
Author: Kevin J. Turpin Date: 14 May 1996 

void DisplayProcessingScreen{ void) 
5 { 

ini originalColor = Text_Color(LIGHTGRAY); clrscr(); 

DisplayLargeMsgd, "IMGBLASTER"); 

// Display the static screen text 

DisplayStaticScreenDataO; 
10 DisplayLocalMACO; 

DispIayLocalGeometryO; 

DisplaylmageGeomelryO ; 

DisplaySockeiNumbersO; 

// Write Eval only copy 
1 5 WriteEvalMessageO; 

Text_Color( originalColor); 

) 

/* Display the hst of connected clients. */ 
20 void 

DisplayClienis( void) 
{ 

int X = wherexO, y = whereyO; 
Clienilnfo *c; 
25 gotoxy( 1, 12); 

cprintf( "Connected Slaves: Currently: %d", 

currentClientCount); 
if ( expectedClientCount != -1) { 

cprintfC" Expecting: %d", 
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cxpeciedaienlCount); 

) 

cprintf("\r\n"); 
if ( DebugBroadcasl) ( 
5 /* Show the MAC addresses for each connected client. */ 

for ( c = clients ; c != NULL ; c = c->ncxl) { 

cprintf("%02x%02x%02x%02x%02x%02x", 
c->nelAddress[ 4], 
c->netAddress[ 5], 
'0 c->netAddrcss[ 6], 

c->neiAddress( 7], 
c->netAddress[ 8), 
c->nelAddressl 9]); 

) 

15 ) 

gotoxy( X, y); 

1 

/* Add information about a client to the client list. 

20 * If the client is already on the list, just return success. 
* 

* Return ZERO on success. nonZero on failure. 
*/ 
int 

25 addClientToLisl( ECB far *ecb) 
{ 

Clienilnfo *c; 
IPXHeader *hdr; 

hdr = (IPXHeader *)ecb->fragnientDescriptor[ OJ.address; 
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for ( c = clients ; c != NULL ; c = c->next) { 

if ( memcmp( c->neiAddress, &hdr->source, 12) == 0) { 
/* Client already on the list. */ 
return 0;/* Success. */ 

5 ) 
) 

/* Client not in the list: add a new node. */ 
c = (Ciientlnfo *)malloc( sizcoR Clicntlnfo)); 
if{c=:NULL) { 
10 return 1;/* Error, */ 

) 

memcpy(c->nelAddress, &hdr->source, 12); 
c->prev = c->next = NULL; 
if ( clients) { 
15 clients->prev = c; 

c->next = clients; 

) 

clients = c; 

curreniCIientCount++; 
20 DisplayClientsO; 
return 0; 

) 

/♦ Send an RSVP ACK packet to a particular diem. 
25 * 

* Reiurn ZERO if successful, nonZero otherwise. 
*/ 
int 

sendRSVPAck( ECB far *ecb) 
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ECB sendECB; 
IPXHeader header; 
RSVPPackei rsvp; 
5 ini transporlTime; 

IPXHeader *reqPki = (IPXHeader *)ecb->fragmenlDescriplorl 0]. address; 
/* Fill in ihe RSVP packet data 
*/ 

rsvp.command = CONFIRM^DOWNLOAD; 
1 0 /* Fill in the IPX packet header */ 
memmove( &header.desiinaiion, 
&reqPkl->source, 
sizeof( reqPkt->source)); 
header.packetType = 4; 
15 /* Fill in the ECB. */ 

sendECB.ESRAddress = 0; 
sendECB.socketNumber = LocalSocket; 
sendECB.fragmentCount = 2; 
sendECB. fragmeniDcscnptor[0].address = &header; 
20 sendECB.fragmentDescripior[0).size = sizeof( header); 

sendECB.fragmentDescriptor[l].address = &rsvp; 
sendECB. fragmentDescripiorfl]. size = sizeof{ rsvp); 
if ( IPXGeiLocalTarget( (BYTE far *)&reqPkt->source, 
sendECB. immediate Address, 
25 &transponTime)) { 

return Oxff; /* Error. */ 

) 

/* Send the packet. */ 
IPXSendPacket( &sendECB); 
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while ( sendECB.inUseFlag) { 

IPXRelinquishConlrolO; 

) 

return sendECB.complelionCode; 

) 

/* Send a Geomeiry broadcast packet. 
* 

* Return ZERO if successful, nonZero otherwise. 
*/ 
im 

sendGeomeiryBroadcastPackeU void) 
{ 

ECB sendECB; 
IPXHeader header; 
GeometryPackel geomPackel; 
/* Fill in the packet data 
*/ 

geomPacket.comniand - GEOMETRY; 
geomPacket.geomCylinders = LocalMaxCylinders; 
geomPackct.geomHeads = LocalMaxHeads; 
geonriPacket.geomSeciors = I^ocalMaxSectors; 
gcomPacket-firsiCyl = ImageFileHeader.partiiionStariCylinder; 
geomPackel.IastCyl = ImageFileHeader.partilionEndCylinder; 
/* Fill in the IPX packet header */ 
/* NETWORK number: */ 

memmove( header.desiinaiion. network, NeiAddress, 4); 
/* NODE number: BROADCAST */ 
memsct( header.deslinalion.node, Oxff, 6); 
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/* SOCKET number: Our special number. */ 

*{WORD *)header.destinaiion.sockei = SWAP^WORD( DOWNLOAD.SOCKET.NUMBER); 

header.packelType = 4; 

/* Fill in the ECB. */ 

sendECB.ESRAddress = NULL; 

scndECB.sockeiNumber = LocaJSocket; 

sendECB.fragmemCount = 2; 

sendECB.fragmenlDescripior|0].address = Aheader; 

sendECB.fragmentDescriptorfOj.size = sizeof( header); 

sendECB.fragmenlDescriptorl 1 J.address = &geomPackei; 

sendECB.fragmentDescriptorf 1 J.size = sizeof( geomPackei); 

memseif sendECB.immediaieAddress, Oxff, 6); /* Broadcast. */ 

/* Send ihe packet. */ 

IPXSendPacket( &sendECB): 

while ( sendECB.inUseFlag) { 

IPXReJinquishControK); 

} 

return sendECB.compJetionCode; 

) 

/**************************************^^ 

/* Send an EXIT broadcast packet. 
* 

* Return ZERO if successful, nonZero otherwise. 
*/ 
im 

sendFareweIIBroadcastPacket( BYTE command) 
{ 

ECB sendECB; 
IPXHeader header; 
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FarewcHPackei packet; 
/* Fiil in the packet data 

*/ 

packet.command = command; 
5 /* Fill in the IPX packet header */ 

/* NETWORK number: */ 

mcmmove( header.destination.network, NelAddress. 4); 

/* NODE number: BROADCAST */ 

memset( header.desti nation. node, Oxff, 6); 
10 /* SOCKET number: Our special number. */ 

*(WORD *)header.destinaiion.sockei = SWAP_WORD( DOWNLOAD_SOCKET_NUMBER); 

header.packetType = 4; 

/♦Fill in the ECB. */ 

sendECB.ESRAddress = NULL; 
15 sendECB.sockeiNumber = LocalSocket; 

sendECBiragmenlCount = 2; 

sendECB.fragmentDescriptor[0]. address = &header; 

sendECB.fragmeniDescriptor|0].size = sizeof( header); 

sendECB.fragmentDescriptor|l). address = &packei; 
20 sendECB.fragmeniDescriptor[l].size = sizeof( packet); 

memset( sendECB.immcdialeAddress. Oxff, 6); /* Broadcast. */ 

/* Send the packet. */ 

IPXSendPacket( &sendECB); 

while ( sendECB.inUseFlag) { 
25 IPXRelinquishConiroK); 

) 

return sendECB.compietionCodc; 

) 
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Program: BroadcastDriveGeomeiry 

Description: This function sends the drive geometry lo the image 
slaves on the send IPX socket. 

5 Author: Kevin J. Turpin Date: 14 May 1996 

void BroadcasiDriveGcometry( void) 
{ 

clock J nextSendTime = 0; 
10 ECB far *ecb; 

/* Initialize the "currently connected clients" display. */ 

DisplayClientsO; 

while ( ! kbhitO) { 

15 IPXRelinquishConlroIO; /* Allow packet processing to occur. */ 

/* Periodically send geometry packets. */ 
if ( cIockQ > nextSendTime) { 
nextSendTime = clock() + CLK_TCK/2; /* Schedule next packet. */ 
20 if ( sendGeomeiryBroadcasiPacketO) ( 

sprinlf(ErrorMessage, "\n\nError sending geometry 

broadcast packet"); 
LogError(SENDPACKETERR, ErrorMessage); 
CleanExitO; 
25 ) 

) 

/* If we RECEIVE any packets, process them. */ 
while ( ( ecb = receivedPackctO) != NULL) ( 
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if { ecb->completionCode 1= 0) { 

DBJNFORM{ "Receive packet error: ccode Ox%x\n'\ ecb- 
>completionCode); 

) 

5 else { 

/* Process ii only ifii's an RSVP packet. 
* First byte of data is the "command". 
*/ 

BYTE command = *(BYTE *)ecb->fragmentDescriptor[ ]].address; 
10 if ( command == RSVP) { 

if ( addCIienlToList( ecb)) { 
DB JNFORM( "Error adding client to list.\n"); 

) 

else { 

1 5 DB JNFORM( "Added clientAn"); 

if ( sendRSVPAck( ecb)) { 

DB JNFORM( "Error sending RSVP ACK packet.\n"); 

) 

DB JNFORM( "Sent ACK."); 

20 } 
) 
) 

IPXListenForPacket{ ecb);/* Repost the listen. */ 
) 

25 /* If the current client count exceeds our licensed client count, 
* print a big bad error message and exit. 
*/ 

if { curremClicniCouni > licenses) { 

sprintf(ErrorMessage. "\n\nToo many clients for current license"); 
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LogError(UCENSEERR. ErrorMessage); 

CleanExitO; 

) 

/* If all clients are with us, we can go ahead and gel siarled. */ 
5 if( expectedClientCount 

&& expeciedClieniCount = currcmClieniCount) { 

/* All clients ready, so let's get started with the download. */ 

break; 

) 

10 ) 

DB_1NF0RM( ''\nDONE Sending drive geometry informaiion.Vi"); 
/* Gobble keystrokes, if any... */ 
while ( kbhitO) { 
gelchO; 

15 ) 
) 

Program: SendOurlPXPackel 

Description: This function sends the IPX packet on the IPX send 
20 socket. 

Author: Kevin J. Turpin Date: 14 May 1996 

/* Send an ipx packet with default size. */ 
void SendOurlPXPackeK void) 
25 1 

SendOurlPXPackclSizedC 512 + sizeoftOurHeader)); 

) 

void 
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SendOurIPXPacketSized( im dataSize) 
{ 

SendHeader.packeiType = 4; 
// Slay on our segment 
5 niemmove(SendHeader.destination.network» NeiAddress, 4); 

// But let any node on our segniem get it (broadcast) 
for (i=0; i<6; i++) { 

SendHeader.desiination.node[i] = Oxff; /* node address of slave*/ 
) 

10 *(WORD *) (SendHeader.destination.socket) = SWAP_WORD( 

DOWNLOAD^SOCKET^NUMBER); 

/* Setup ECBs */ 

SendECB.ESRAddress = 0; 

SendECB.sockctNumber = LocalSocket; 
15 SendECB.fragmenlCount = 2; 

SendECB.fragmentDescripiorIO].address = ASendHeader; 

SendECB.fragmentDescriptor[0].size = 30; 

SendECB.fragTnentDescriplor[l J.address = IPXSendBuffer; 

SendECB.fragmenlDescriplorl IJ.size = dataSize; 
20 for (i=0; i<6; i++) ( 

SendECB.immedialeAddress[i] = OxFFJ* broadcast packet */ 

) 

menmiove(lPXSendBuffer, &OurHeader, sizeof(OurHeadcr)); 
IPXSendPackeiC&SendECB); 
25 while (SendECB.inUseFlag 1=0) 

IPXRelinquishControK); 
/* If error sending packet, let calling function know */ 
if(SendECB.completionCode != 0) 

print f("\nError sending packet!"); 
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) 

Program: ReadDriveHeadAt 
Description: Generic bios disk interface. 
5 If there arc any errors, they are reported. The process 

is aborted after 5 retries on errors. 
CRC type errors are not necessarily fata!, so we will not 
abort on them (code = 0x1 1). 

1 0 void ReadDriveHcadAt( inl drive, 

int cylinder, 

int head, 

int sector, 

int sectorCount, 
15 unsigned char * buffer) 

{ 

int ccode, 

relryCoum = 0; 

do { 

20 // Try to read the head 

ccode = biosdisk{READ, 
drive, 
head, 
cylinder, 

25 sector, 

seciorCounl, 
buffer); 
if ( ccode) { 

Displays iosError( ccode, 20, 25); 
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} 

) while ( ccodc && retryCount++ < 5); 
if ( ccode && ccode != 0x1 1) { /* Tolerate CRC "errors". */ 
sprintf(ErrorMessage, 

"\n\nBios error %d reading at cylinder %d, head %d*\ 

ccode, 

cylinder, 

head); 

LogEnrorCBIOSERR, ErrorMessage); 
CleanExilO; 

} 

1 

Program: ReadDriveHead 

Descripiion: This function reads a head worth of data from the 

local hard drive at the global variable CurrcntCylinder and 
CurrentHead. 

If there are any errors, they are reported. The process 
is aborted after 5 retries on errors. 
CRC type errors are not necessarily fatal, so we will not 
abort on them (code = 0x11 ). 
Author: Kevin J. Turpin Date: 14 May 1996 

void ReadDnveHcad(unsigned char * buffer) 
1 

ReadDriveHeadAi( CurreniHDDrive. 

CurrcntCylinder, 

CurrentHead, 

1, 
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LocalMax Sectors, 
buffer); 

) 

5 /* Send data for an entire HEAD. 
*/ 

void 

BroadcastGivenHead( long cylinder, 
long head, 

10 unsigned char *buffer, 

long numSectors) 

I 

long i; 
int drop)! = 0; 
1 5 // Stuff the header for this head 

OurHeader.command = STD_DATA; 
OurHeader.head = head; 
OurHeader. cylinder = cylinder; 
// Send each sector of data, packet it and send it 
20 for (i=0; i<numSectors; i++){ 

meniniove(&!PXSendBuffer[sizeof(OurHeader)], 

&buffer((int)i*512],512); 
OurHeader.sector = i+1 ; 

if (i == nuniSeclors- 1 ) // on the iasi sector, write it 
25 OurHeader.command = FLUSH; 

iemhMiniDelay(De!ayValue); /* Inter-packet delay. */ 

if { DebugBroadcast) { 

/* FAKE DROPPING A PACKET. 



wo 98/50874 



PCTAJS98/09018 



88 

* also allow keyboard conlrol of delay values 
*/ 

if(kbhii()) { 

swiich( geichO) { 
5 case '*': 

if ( FlushDelay > 0) { 
FIushDelay*-; 

) 

showDelayValuesQ; 
break; 

case '9': 

FlushDelay++; 
showDelayValuesO; 
break; 

case 

if (Delay Value >0){ 
DelayValue--; 
) 

ShowDelayValuesO; 
break; 

case '+': 

DelayValue++; 
ShowDelayValuesO; 
break; 

case V: ( /* Show ihe perDelay values. */ 
int d; 

int x=wherex(), y=whereyO; 
for ( d = 0 : d < 20 ; d-H-) { 
goioxy(40,d+l); 
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cprimfC'd %d: m %Id, s %Id'\ 
d. 

perDelayCountsf d].headsMissed, 
perDelayCountsf d].headsSent); 
5 /* Avoid divide-by-zero errors */ 

if ( perDeIayCounls[ d].headsSeni f= 0) { 
cprintf(". ratio %5Ar, 

( (floai)perDelayCoums[ d].headsMissed 
/ (float)perDelayCounisl dJ.headsSeni)); 

10 ) 

cIreoK); 

) 

goioxy( X. y); 
break; 

15 ) 

default: 

DB_INFORM( "DROPPED A PACKET. An '); 

droplt = 1; 

break; 

20 ) 
) 

if(dropIl){ 

droplt = 0; 
25 continue; 

) 

) 

#if defincd( KEY.ENABLE^DEBUG) 
else I 



wo 98/50874 



PCTAJS98/09018 



90 

if(kbhit()) { 

if(gelch() = '@'){ 

if ( DebugBroadcasi != TRUE) ( 

DebugBroadcast = TRUE; 

DB JNFORM( "DebugBroadcast Enablcd.Nn"); 

) 

else { 

DB_INFORM( "DebugBroadcast Disabled.\n"); 
DebugBroadcast = FALSE; 



10 



) 

} 

) 

#endif 

15 /************************************* ********^ 

SendOurlPXPackctO; 

} 

ienlhMi]IiDelay(FlushDelay); 

) 

2Q /************************************************************ 
/* Send a "skip this track" command. 
*/ 

void 

BroadcaslSkipHead( long cylinder, 
25 long head) 

( 

ECB sendECB; 
IPXHeadcr header; 
SkipTrackPackei sip; 
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/* Fill in the packet data 
*/ 

slpxommand = SKIP^TRACK; 
stp.cylinder = cylinder; 
5 sip.head = head; 

/* Fill in the IPX packet header */ 
/* NETWORK number: */ 

memmove( header.destination.network, NetAddress, 4); 

/* NODE number: BROADCAST */ 
10 memsei( header.desti nation. node, Oxff, 6); 

/* SOCKET number: Our special number. */ 

*(WORD *)headcr.deslinaiion.sockei = SWAP_WORD( 
DOWNLOAD_SOCKET^NUMBER); 

header .packelType = 4; 
15 /* Fill in the ECB. */ 

sendECB.ESRAddress = NULL; 

sendECB.socketNumber = LocalSockei; 

sendECB.fragmentCount = 2; 

sendECB.fragmentDescripior[0].address = &header; 
20 scndECB.fragmentDescriptorlOj.sizc = sizeof( header); 

scndECB.fragmentDescriptor[l J. address = &stp; 

sendECB.fragmentDescriplorllJ.size = sizeof( sip); 

memsei{ sendECB.innmediateAddress. Oxff, 6); /* Broadcast. */ 

ienth.MiI!iDe!ay(DelayValue); /* Inier-packet delay. */ 
25 z*********************************************^ 

/* Send the packet. */ 
IPXSendPackeK &sendECB); 
while ( sendECB.inUseFlag) { 

IPXRelinquishControlO; 
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} 

if { sendECBxompleiionCode) { 

DB JNFORM( "Error sending SKIP packetAn"); 

) 



5 ) 



/* Reiransmil a track-it was missed by one or more clients. 
*/ 

void 

1 0 retransmitTrack( long cylinder, 

long head) 

{ 

/* Check ID make sure the track is valid on the disk. 
* We make sure the requested track isn't beyond the "valid 
15 * up thru" track that vk^e know is on the disk. 

*/ 

if ( ! ( CHiessThan( cylinder, head, 
ValidUpThruCylinder, ValidUpThruHead) 
II CHEqual( cylinder, head, 
20 ValidUpThruCylinder, ValidUpThruHead))) { 

DB JNFORM( "Ignoring resend request: (%ld.%ld) GT validUpThru {%ld.%ld).\n", cylinder, 
head,(long)CurrentCylinder, (long)CurrenlHead); 
return; 

1 

25 /* #defme NO_1NUNE_REBROADCASTS */ 
#if denned( NO_INLINE_REBROADCASTS) 
if (Phase == BLAST) { * 

DBJNFORM( "Cliem(s) Lost Track (%ld,%ld).\n", cylinder, head); 
return; 
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) 

#endif 

/* Read ihe track from the local disk into the HeadBuffer */ 
ReadDriveHeadAl( CurrentHDDrive, 
5 (in!)cylinder, 

(int)head, 

1. 

LocalMaxSectors. 
HeadBuffer); 

10 /* Now send the entire track. */ 

BroadcastGivenHead( cylinder, 
head, 

HeadBuffer, 
LocalMaxSectors); 
1 5 DB JNFORMC "Resent track (%ld.?cld)An", 

cylinder, head); 

) 

/* Return TRUE if we really slowed down. */ 
20 int 

slowDown( void) 
{ 

DeJayValuc++; 

DB JNFORM{ "Slowed to delay %d", DelayValuc); 
25 showDelayValuesO; 
return 1 ; 

) 

/* Return TRirE if we really sped up. */ 
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int 



speedUpC void) 



int i; 



5 



int lowestNonZeroRaliolndex = -1; 



float 



current_ratio; 



if( Phase != BLAST) ( 



return 0; 



if(DelayValue>0) { 



if ( DelayValue >= NUM_DELAYS) { 

DB_INFORM( "Speeding up incrementally: Delay is 

BlG.\n"); 
DelayValue-; 
showDelayValuesO; 
return 1 ; 



/* Find the delay slot with the best "eligible" rating. 

* A delay value is eligible if we've sent less than 

* 50 heads at that value, or if we've sent more than 

* 50 heads and missed fewer than two percent of them, 

* but NEVER if the consecutivcDaiaLosses flag is set 

* for thai speed. 



for ( i = 0 ; i < NUM_DELAYS ; i++) { 

if ( perDelayCounis[ ijxonsecutiveDaiaLosses) ( 




25 



*/ 



continue; 



/* This one's NOT eligible. */ 
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if ( perDelayCounis[ i].headsSent < 50) { 
/* Hey, this is the one we want! */ 
lowestNonZeroRalioIndex = i; 
break; 

5 ) 

currenuratio = ( {floai)perDeIayCountst i].headsMissed 
/ (floai)perDelayCoums[ iJ.beadsSent); 
if ( currenl_ralio <= 0.02) { 

/* We warn this one. */ 
1 0 lo wesiNonZeroRatioIndex = i ; 

break; 
1 

) 

if ( lowesiNonZeroRatiolndex = -1) { 
J 5 /* NO desirable ratio. */ 

DB JNFORM( "NOT speeding up: no desirable ratio.Xn"); 

showDelayValuesO; 

return 0; 

) 

20 if { DelayValue > lowestNonZeroRaiioIndex) { 

DB_INFORM( "Speeding up: current %u > want %u\n", 
DelayValue, lowestNonZeroRalioIndex); 
DelayValue = lowestNonZeroRalioIndex; 
/* Jump right to our goal. */ 
25 ShowDelayValuesO; 

return 1; 

) 

DB JNT-ORM( "NOT speeding up: current %u <= want %u\n". 
DelayValue, lowestNonZeroRalioIndex); 
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) 

else { 

DB JNFORM( "NOT speeding up: Delay already ZeroAn"); 
) 

5 showDelayValuesO; 
return 0; 

) 

typedef struct { 
10 long cylinder; 

long head; 

unsigned ini count; /* Count of requests for this track. */ 

) ResendRequest; 

ResendRequesi resendRequestsf NUMBER_ECBs]; 
^ ^ loialResendRcquesls = 0; 

/* We shouldn't have more unique enuies here than we have ECBs. This * is because we clear and recreate 

the list approximately once per "ecb * listen post" Joop. 

*/ 

20 void 

zeroResendRequests( void) 
{ 

inti; 

for ( i = 0 ; i < NUMBER^ECBs ; i++) | 
25 resendRequests[ ij.cylinder = resendRequesls[ i].hcad = - 1 L; 

resendRequestsI i]. count = - 1 ; 

) 

lotalResendRcquests = 0; 
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/* A client has requested a rescnd of a track. Record the cylinder and * head, and bump the count of 
clients that have requested that track. 
*/ 

5 void 

recordResendRequesl( long cylinder, 
long head) 

\ 

im i; 

10 for ( i = 0 ; i < NUMBER.ECBs ; i++) { 

if ( resendRequesls[ ij.cylinder == cylinder 

&& resendRequesisI ij.hcad = head) { 

/* Found slot. Just bump the count and we're done. */ 

resendRequests[ i].count++; 
IS toialResendRequests++; 

return; 

) 

/* Else the slot didn't match. If the slot is empty, record the 
* new irack request and we're done. 
20 */ 

if ( resendRequests[ ij.cylinder == -IL) { 

resendRequesls[ ij.cylinder = cylinder; 
resendRequests[ i].head = head; 
resendRequesis[ i} .count = 1 ; 
25 iolalResendRequests++; 
return; 

) 

) 

/* Zowec! Out of slots in the resend table! */ 
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DB_INFORM( "Out of slots in resend table. Dropping resend request.Nn"); 
) 

/* Process the resendRequests list. Send the tracks and update the 
5 * delay counters if we have enough clients requesting a particular * * track. 

* Return number of heads missed. 

*/ 

10 int 

processResendList( void) 
{ 

int i; 

unsigned int missedHeadCount = 0; 
15 unsigned im missedHeadSum; 

unsigned int nConsecutiveLostDaia = 0: 
unsigned int nMaxConsecuiiveLoslDaia = 0; 
unsigned inl nCIientRequesis = 0; 
/* First see if wc need lo slow down. */ 
20 for ( i = 0 ; i < NUMBER_ECBs ; i-f+) { 

if ( resendRequests! ij.cylinder == -IL) { 
/* No more requests. */ 
break; 

) 

25 /* Sum up total of client requests. */ 

nCIientRequesis += resendRequests! i]. count; 
niissedHeadCount++; /* Bump local counter. */ 
totalHcadsMissed++; /* Update global counter. */ 

) 
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/* If we miss some daia,pul off the next speedup aitempi for a while. */ 
if ( missedHeadCoum) { 

timeForNextSpeedup = NEXT_SPEEDUP(); 

) 

/* Compute sliding window of lost daia-used to 

* trigger slowdowns. 
*/ 

numberSamplesThisWindow++; 

windowSamplesI windowSlot) = nClientRequests; 

for ( i = 0. missedHeadSum = 0 ; i < WINDOW JIZE ; i++) { 

/* update counter of total slots with missed heads. */ 

if ( windowSample$[ i]) { 

missedHeadSum++; 

) 

/* Update maximum run of slots with more than (say) ten percent 

* of clients reporting 
*/ 

if ( WindowSamplesI i] > ( curreniClientCount / 10)) { 
nConsecuiiveLostData++; 

if ( nConsecutiveLosiDaia > nMaxConsecutiveLostData) { 

nMaxConsecuiiveLostData = nConsecuiiveLostData; 

I 

1 

else { 

nConsecutiveLosiDaia = 0; 
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/* Slow down if we have more than '2n' consecutive missed heads, 

* OR if we have more than 'n' missed heads in the window. 
*/ 

5 if ( ( nMaxConsecuiiveljOSlDala > ( 2 * SLOWDOWN^THRESHOLD)) 

II. ( numberSamplesl^iis Window > W1ND0W_SIZE 

&& missedHeadSum > SLOWDOWN.THRESHOLD)) { 
/* If we're slowing down due to consecutive data losses, 

* mark this delay value ineligible for spe;edup consideration. 
10 */ 

if ( nMaxConsecutivcLoslData > ( 2 * SLOWDOWN_THRESHOLD)) { 
if ( 0 <= DelayValue && DclayValue < NUM.DELAYS) { 
perDelayCountslDeIayValue].consecuiiveDaiaLosses = 1; 
) 

15 else I 

outOfRangcCounis.consecutiveDaiaLosses = 1 ; 

) 

1 

slowDownO; /* Bump the delay. */ 
20 /* Reset window-start collecting data on lost heads from scratch. */ 
for ( i = 0 ; i < WINDOW.SIZE ; i++) { 
windowSamplesI i] = 0; 

) 

windowSlot = 0; 
25 numberSamplesThisWindow = OL; 

/* Reset the next speedup time so we don't 
* speed right back up again. 
*/ 

limeForNextSpeedup = NEXT_SPEEDUP(); 



wo 98/50874 



PCTAJS98/09018 



101 

/* Clear the perDelay values for the slower speed so thai 
* we start acquiring new data. 
*/ 

if ( 0 <= DeiayValue && DelayValue < NUM^DELAYS) { 
5 perDelayCounts( DelayValue] .hcadsSent = 0; 

perDelayCountsf Delay Value]. headsMissed = 0; 

) 

) 

50 /* Resend the track(s) al the (possibly slower) speed. */ 

for ( i = 0 ; i < NUMBER_ECBs ; i++) ( 

if ( resendRequesls[ i].cylinder = -]L) { 
/* No more requests. */ 
break; 

15 ) 

retransmitTrack( rescndRcquests[ ij.cylinder, 
resendRequests[ i].head); 

) 

20 /* Update the perDeiay values. */ 

If (Phase == BLAST) { 

if ( DelayValue < NUM_DELAYS) { 

perDelayCounisl DeIayValue].headsScni++; 
if { missedHeadCoum) { 
25 perDelayCounts[ Delay Value].headsMissed++; 

} 

) 

else { 

outOfRangeCounis.headsSem++; 
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if ( missedHeadCount) { 

outOfRangeCoums.headsMissed++; 



/* Speed up if weVe had a number of good tracks in a row. 
*/ 

if ( clockO > limeForNextSpeedup) ( 
10 speedUpO; 

limeForNextSpeedup = NEXT_SPEEDUP(); 
) ' 

. /* Update the ''lost data" window. */ 
1 5 windowSlot = ( windowSlol + 1 ) % WINDOW_SIZE; 

return missedHeadCount; ■ 

) 

/* Ciiems are leaving us. Remove them from our clieni list and 
20 * send them a "farewell ACK" packet. 
*/ 

BYTE 

processFarewellPacketC IPXHeader *reqHdr) ' 
• { 

25 Clientlnfo *c; 

ECB scndECB; 
IPXHeader header; 
FarewellPacket packet; 
int iransporiTimc; 
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for ( c = clienis ; c != NRJLL ; c = c->next) { 

if ( memcinp( c->netAddress, &reqHdr->source. 12) == 0) { 
/* Found the client: Remove it from our list. */ 
if ( c->prev) { 

5 c->prev->riext = c->nexl; 

) 

if {c->nexl) { . 

c->nexi->prev = c->prev; 

) 

10 if ( c == clienis) { 

clients = c->next; 

! 

. currenlClieniCoum-s/* One less client on list. */ 
/* Free the storage. */ 
15 free(c); 

break;/* DONT continue loop: variable 'c* nowinvalid; 

* and we're done anyway because the client has been 

* removed from the list. 

7 

20 ) 
1 

/* Send back a farewell ACK packet. */ 
/* Fill in the RSVP packet data 
*/ 

25 packei.command = FAREWELL_ACK; 

/* Fill in ihe IPX packet header */ 
memmove( &header.destination, 

&reqHdr->source, 

sizeof( reqHdr->source)); 
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header. packetType = 4 ; 
/* Fill in the ECB. »/ 
scndECB.ESRAddress = 0; 
sendECB.sockelNumber =: LocalSockei; ' 
5 sendECB.fragmentCounl = 2; 

sendECB.fragmentDescriplor[0).address = &header; 
sendECB.fragmentDescriptor[0].si2e = sizeof( header); . 
sendECB.fragmentDescriptor{ 1 J.address = &packel; 
sendECB.fragmemDescriptorf 1 ].size = sjzeof( packet); 
10 if ( IPXGetLocalTargeK (BYTE far *)&reqHdr->source. 

sendECB .immediate Address, 
&lransportTime)) { 
return Oxff; /* Error. */ 

) 

15 /* Send the packet. */ 

IPXSendPacket( &sendECB); 
'While ( sendECB.inUseFlag) { 

IPXRelinquishControlO; 

} 

20 return sendECB.complclionCode; 

) 

. /* Process packets from the clients. 
* 

25 * Return count of packets that were processed. - 
* 

*/ * ' * 

long 

proccsslnconiingPackeisC void) 
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{ 

long processedPackets = OL; 

ECB far *ecb; 

do{ 

5 /* Clear the list of rescnd requests. */ 

zeroResendRequestsO; 
while ( ( ecb = receivedPackeiO) != NULL) { 
processedPackets++; 
if ( ecb->completionCode != 0) { 
1 0 DB JNFORMC "Receive packet error: ccode Ox%x\n". ccb->compIelionCode); 

) 

else [ * 

/* Process only "rescnd" and "farewell" packets. 
* First by of data is the "command". 
15 . */ 

BYTE command = *(ByTE *)ecb->fragmenlDescriptor[ l].address; 
switch( command) { 
case RESEND.REQUEST: { 
ResendPackei *rp = (ResendPackel *)ecb->fragmentDcscriptor[ l].address; 
20 recordResendRequesl( rp->cylinder, rp->head): 

/* If in big debug mode, display MAC addresses of clients that missed 
* packets. 
*/ 

if( DebugBroadcastDisplayMACs) ( 
^5. IPXHeader *hdr (IPXHeader *)ecb->fragmentDescripior[ 0]. address; 

DBJNF0R]V1( "Client requested resend. MacAddr: 0x%02x%02x%02x%02x9b02x%02x\n", 

hdr->source.node[ 0]. hdr->source.node{ 1), 

hdr->source.node[ 2], hdr->sourcc.nodc[ 3], 

hdr->source.node[ 4], hdr->source.nodc[ 5]); 
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else { 

DBJNFORM( "RecordedResentRequesiAn"); 
} • ' • ' 

5 break; 
) 

case FAREWELL: { 

IPXHeader *hdr = (IPXHeader *)ecb->fragmentDescripior( 0].address; 
BYTE ccode; 
10 ccode = processFarewellPacket( hdr); 

if ( ccode) { 

DBJNFORJM( "Error Ox%x fromprocessFarewellPackeiAn", ccode); 
) . • • 

else { 

^ 5 DB JNFORMC "Successful processFarewellPackei().\n". ccode); 

) 

break; 

) 

default: 

20 DBJNFORM( "plP: Ignoring unknown packet cmd Ox%x.\n". command); 

break; /* Ignore other packets. •/ 

) 

) 

IPXListenForPacket( ecb);/» Reposi the listen. •/ 
25 ) 

/* Now send the missing tracks. If we resent any, 
* run the loop again to check for more lost data. 
*/ 

) while ( processResendListO); 
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rcium processedPackets; 
) 

/* • • 

5 * Send "EXIT" (AKA no more data) packets every second or so. 

* Respond to RESEND^REQUEST packets with track resends. 

* If we don't get any RESEND.REQUESTS for a while. 

* we're done. 
*/ 

10 . void 

handleLateRcsendRequesis( void) 
{ 

docket nextSendtime = 0; 
clock.i slanOfldle = clockQ; 
15 while(]){ 

IPXRelinquishConirolO; /* Allowpackeiprocessingio occur. */ 

/* Periodically send EXIT packets. */ 
20 if ( clockO > nexlSendTime) { 

nextSendTime = cIock() + CLK_TCK/2; /*Schedule next packet*/ 
if ( sendFarewel!BroadcastPacket( EXIT)) { 
* sprintf(ErrorMessage. "\n\nError sending EXIT broadcast packet"); 
LogErTor(SENDPACKETERR, EirorMessage); 
25 CleanExiK); 



if( process] ncomingPacketsO) { 

7* Packet was processed, so restart the idle timer. */ 
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siartOfldle = clockQ; 

/* Also send another EXIT packet to prompt remaining clients 
* to send us RESEND requests NOW. 

. */ 

5 nextSendTime = cIock() - 1 ; " * 

) 

/* BAIL OUT if timeoul. */ 

if ( ( cIockQ - SiartOfldle) > ( 5 * CLK^TCK)) { 

DB JNFORM( "Leaving EXIT phase due to idle timeout.\n"); 
10 break;. /* TIMEOUT*/ 

) 

/* BAIL OUT if key pressed. */ 
#if defined( KEY_ENABLE_DEBUG) 
if(kbhit()){ 

while ( kbhitO) { 

if(gelch()=='@'){ 

if ( DebugBroadcasi != TRUE) { 

DebugBroadcast = TRUE; 
DB JNFORM( "DebugBroadcasi Enabled.Xn"); 
) _ 
' else { 

DB JNFORMC "DebugBroadcasi Disabled.Vn"); 
DebugBroadcasi = FALSE; 

} 

) 

the. { 

DB JNFORM( "Leaving EXIT phase due to keypress.Vn"); 
return; 
) 
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} 

} 

#clse 

jf(kbhjt()){ 
5 while ( kbhitO) { 

(void)getch(); 

} 

DB^INFORM( "Leaving EXIT phase due lo keypress.Xn"); 
break; 

10 ) ' 

#endif 

) 

) . 

1 5 /* Prim a list of clienis thai didn't disconnect (yet). 
*/ 

void 

showHangingCJienls( void) 
{ 

20 • CIienarifo*c; 

int i; 

inform( stderr, "\nThe following clients have not yet disconnected.An"); 
for ( c = clients, i = 0 ; c != NULL ; c = c->next) { 
inform( stderr, 

25 "%02x%02x%02x%02x%02x%02x 

c->netAddrcss[ 4], 
c->nelAddress[ 5], 
c->net Address [ 6]. 
c->neiAddress[ 7], 
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c->nelAddress[ 8], 
c->netAddress[ 9]); 
if(++i>=4)| 
i = 0; 

inform( siderr. "\n*'); 

) 



10 /* 

* Send "GOODBYE" packets every second or so. 

* Respond to "FAREWELL" packets by removing the client 

*• from our list and sending back "FAREWELL^ACK" packets. 

* When we gel gel no requests for a while, OR our client 
15 * list becomes empty, we're done. 

*/' 
void 

sayGoodbyeToClients( void) 

{ , • * 

20 clock_i nexiSendTime = 0; 

docket siarlOfldle = clock(); 
. while ( 1) ( 

IPXRelinquishConirolO; /* Allow packet processinglo occur*/ 
25 /*************************«********»********»*z 

/* Periodically send GOODBYE packets. */ 
if ( clockO > nexiSendTime) | 

nexiSendTime = ciock() + CLK_TCK/2; 
/* Schedule next packet. */ 
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if (sendFarewellBroadcastPackel( GOODBYE)) ( 
sprintf(ErrorMessage, "\n\nError sending DISCONNECT broadcast packet"); 
. LogError(SENDPACKETERR. ErrorMessage); 
CleanExilO; 
5 ) 
} 

if( processIncomingPacketsO) { 
/* Packet was processed, so restart the idle timer. */ 
startOhdle = c]ock{); 
10 }' ' • . . 

/* We're DONE if the client list becomes empty. */ 
if ( clients NULL) { 

TopLargeMsg( 0, " DONE "); 
infonD( stderr, "\n\nAll clients have disconnected. We're done.\n"); 
15 break; 

} 

/♦BAILOUT if timeout.*/ 
■ if ( ( clockO - startOffdle) > ( 5 * CLK^TCK)) { 
inform( stderr, "\n\nLeaving DISCONNECT phase due to idle timeoul.\n"); 
20 showHangingCliemsO; . .. 

break; /* TIMEOUT */ 
) 

/* BAIL OUT if key pressed. */ 
#if defined( KEY_ENABLE_DEBUG) 
25 if(kbhit()){ 

while ( kbhitO) | 

if{getchO ==•<§>'){, 

if ( DebugBroadcast != TRUE) { 

DebugBroadcasi = TRUE; 
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DB JNFORM( "DebugBroadcast Enabled.\n"); 
else ( 

DBJNFORM( "DebugBroadcast Disabled.\n"); 
5 DebugBroadcast = FALSE; 

1 

) 

else { 

inform( siderr, "\n\nLeaving DISCONNECT phase.due to keypressAn"); 
J 0 showHangingQientsO; 
return; 

} * ' ■ 

} ■ ■ ' 

15 #else 

if(kbhil()){ 
while ( kbhitO) { 

(void)getch(); 

) 

20 inform( stderr, "\n\nLeaving DISCONNECT phase due to keypressAn"); 
showHangingClientsO; 
break; 
) 

#endif 

25 ) ' • ' 

) 

/* Finish broadcast processing. 
*/ 
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void 

finishBroadcasiProcessingC void) 
i 

Phase = CLEANUP; 
5 TopLargeMsg( 0, nNISHING "); 

handleLateResendRequesisQ; 
. TopLargeMsg( 0, "DISCONNECT -); 
sayGoodbyeToClientsO; 

) 

]Q /**********************************************♦*********#* 

Program: BroadcaslHead 

Descripiion: This function broadcasts the drive head of data (HeadBuffer)lo the image slaves 
using the send IPX socket. The data is sent 512 bytes at a time (sector of data). On the last 
sector, the coirunand to flush the data (write it to the hard drive) is sent. 
15 Author: Kevin J. Turpin Date: 14 May 1996 

void BroadcasiHcad( void) 
{ 

/* Typically, we only broadcast a head when it contains valid data. 
20 * But the ForccWrilcDala'flag can override and cause us to always 
* write the real data. 
*/ 

if ( ValidDaialnHead == TRUE II ForceWriteDaia == TRUE) { 
BroadcastGivenHead( CuneniCylinder, 
25 ; CurrentHead, 

HeadBuffer, 
LocalMaxSeclors); 



else { 
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BroadcastSkipHead( CuirentCylinder, 

CurrenlHead); 

) 

5 /* Process any incoming packets: If we have a "resend" 

* request, read that head from the disk and send it. 

*/ . ' 

processlncomi ngPacketsO; 

lotalHeadsSent++; /* Update and periodically display counters. */ " 

10 displayTotalAndMissedHeadsO; 
) 

Program: CompressHead 

Description: This function is the main compression controller for this program. It is responsible 
. 15 for taking the HeadBuffer and 

compressing the data, writing it to CompressBuffer, and 
flushing the CompressBuffer when it is full (or close to 
full). 

The "Run-Length" compression algorithm used in the old 
20 PCX graphics files will be used. This compression algorithm 

compresses by counting the number of consecutive bytes 
that contain the same data and then representing this 
data as three bytes: 

BYTE DATA 

25 

1 ' Compression Key (ID) 

2 Compression Count (Run Count) 

3 Data 

The first byte indicates that the next two bytes contain 
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compressed daia. The second byte represents the number of 
limes ihe data (third byte) is replicated. 
The compression Key (ID) should be somewhat unique (not 
highly probable to be on the drive). Novell's disk image 
5 program uses a key id of 0xD5. We will use the same key 

to make this program capable of uncompressing Novell's 
images in the event Novell uses our lab and wants to use 
their own images. 

There may be multiple HeadBuffers compressed into a single 
CompressedBuffer. Therefore, we will keep some pointers 
between HeadBuffers. The following pointers/counters are 
used for the compression: 

LasiDaia - contains the last byte of data being compressed 
Current - contains the current byte being evaluated 
CompressCount - counts the number of bytes that are the 

same. 

Returns ZERO on success, nonZero on failure. 
Author: Kevin J. Turpin Date: 15 May 1996 
20 ********************************************************** 
im 

CompressHead( void) 
{ 

int i; 

25 int error = 0;/* Always successful, unless 

* WriteDaiaToCompressBuffer fails. 
• */ 
// Let's start at the begining of the HeadBuffer 
LastDaia = HeadBuffer! 0]; 
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//We start clean on each head. 
ComprcssCoum = 1; 
// Now run through the HeadBuffer 
for (i= 1 ; i<LocalMaxSeci6rs*5 1 2; i++) { 
5 Current = HeadBuffer(i]; 

// Temporary test (Kevin) 

if (Current != FILLDATA && 

ValidDatalnHead != TRUE) 
ValidDatalnHead = TRUE; 
' ^ // Wc only need to work with the compress buffer if we are 

// wiling 10 an image file. 
ifdmageFileNameValid ==TRUE) { 
//If current is the same as last, it can-be compressed, count it 
if (Current == LastDaia) ( 
^ ^ CompressCount++ ; 

if (CompressCouni 255) {// largest count in a byte • 
error 1= WriieDataToCompressBuffer(); 
CompressCount = 0;//reset to Osince we are still 
) // compressing. 

20 , 

c*se { // does not compress any longer 

if (CompressCount > 0) {//If we were compressingbefore 

error 1= WriteDataToCompressBuffer(); 
// move it to the ConipressBuffer 

25 , . • 

LastData=Curreni; // gel ready for next evaluation 

CompressCouni = 1 M reset to 1 since the next byte 
) // may not compress. 
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) 

// for simplicity, we will not try to compress across HeadBuffers 
// therefore, if we have data that needs lo, be written to the 
// CompressBuffer. let's do it. 

5 if(CompressCounl>0&& ' 

ImageFileNameValid == TRUE) { ' 
error 1= WrileDataToCompressBuffer(); ' 
CompressCount= 1; 

) ■ ' ' ' ^ 

10 return error; 

) 

Program: WritcDalaToCompressBuffer 

Description: This function writes the compress data into the 
*5 CompressBuffer. Compressed data is represented in 

three byies of data (as explained in CompressHead function). 

Therefore, it the CompressCouni is less than 3. there is 

no savings in representing the data in compressed format. 

When the CompressBuffer is almost full (within 3 bytes of 
•0 its limit), we will flush it to the image file. 

Returns ZERO on success, nonZero on failure. 

Author: Kevin J. Turpin Dale: 6 May 1996 
Mod 1: Added display of counters for debug purposes. Kevin - Oct 29. 1996 

25 int ; . 

WriteDataToCompressBuffer( void) 
I • 
int error = 0; 

/* Always successful, unless FlushCompressBuffcr fails. */ 
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// Is it efficient to represent the data in compressed format? 

// If data is same as compression key, put it in compressed format so 

// that it doesn't confuse us during uncompressing. 

if ((CompressCount > 2) II 

(LasiDala == COMPRESSIONKEY)) ( // yes 

CompressBuffer[(unsigned inl)CoinpressPTR++J = COMPRESSIONKEY; 

CompressBuffer[(unsigned int)CompressPTR-H-] = CompressCount; 
ComprcssBuffer[(unsigned int)CompressFrR++] = LastData;//actual data • 

//If we need debug info, display Compressed Key count value 

if(DebugFlag = TRUE){ 

if (LasiData = COMPRESSIONKEY) { 

gotoxy(55, 22); 

cprintf("%81d'\ CKCount++); 

) 

else if (LastDala == FILLDATA) ( 
goioxy(65, 22); 
cprimf("%#9Id'\ FDCount++); 
goioxy{76, 22); 

cprinlf("%#3d'\ CompressCount); 
I 

) 

) 

else! //n6 

for (i=0; i<CompressCounl; i-f-+) ( 

CompressBuffer((unsigned inl)CompressPTR++] = LastData; 
. ) 

) • 

// Is the CompressBuffer close enough to being full? 
if (CompressPTR >= (LocalMaxSectors*5I2)-6) ( 
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error = FlushCompressBuffer(),// then flush it to image file 
CompressPTR = 0; 

. ) 

return error; 

) 

Program: FlushCompressBuffer 

Description: This function flushes the CompressBuffcr to the image 
file. 

Returns ZERO on success. nonZero on failure. 
Author: Kevin J. Turpin Dale: 6 May 1996 

int 

FlushCompressBuffer( void) 
I 

// Write the contents of the CompressBuffer to disk 
return ( ( wriie(ImageFileHandle, CompressBuffer, (unsigned 
int)ComprcssPTR) 
== (unsigned int)CompressPTR) 
. ?0 /* SUCCESS*/ 

:1); /* ERROR*/ 

) 

Program: Downloadlmage 
Description: This function performs the downloading of the image (drive 
data). If a filename was specified by the operator, it is 
opened and the drive data is read from the file. 
If the broadcast feature is enabled, the data is broadcasted 
10 the image slaves on the network. 
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Author: Kevin J. Turpin Date: 15 May 1996 
**************************************^^^ 

void DownloadImage( void) 
{ 

// Initialize needed data 

HeadBufferPTR = 0; // empty HeadBuffer to start 

// Open the image file if.necded and read the image header, 
if (ImageFileNameValid = FALSE) { 

/* We CANNOT download without a valid image file name. */ 

sprintfCErrorMessage, "\nNeed filename for download"); 

D!splayLargeMsg(l. " Error"); 

LogError{NEEDFlLENAMEERR, EirorMessage); 

CleanExitO; 



^ 5 if ((ImageFileHandle = open(lmagcFileName, 

0_RDONLYIO_BINARY, 
SJREAD))==>1) { 
sprintf(ErrorMessage. "\nError opening image file %s", 
ImageFileName); 
2^ • DisplayLargeMsg{), " Error"); 

LogError(nLEOPENERR. ErrorMessage); 
CleanExitO; 

) 

// Read the image file header and check for proper drive geometry • 
-5 if ( read(ImageFileHandle, AlmageFileHeader, 

sizeofOmageFileHeader)) 
f= si2eof( ImageFileHeader)) ( 
sprintf(ErrorMessage, "\nError reading image file %s", 
ImageFileName); 
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DisplayLargeMsg(], " Error"); 
LogError(READERR, ErrorMessage); 
CleanExitO; 

} 

5 CheckGeometryO; 

// If broadcast enabled, leis pause and let operalor start process 
if (BroadcastEnableFlag == TRUE){. 

DisplayLargeMsgd, " PAUSING"); 
printf("\n\nPress any key to start the download and 
10 broadcast process..."); 

BroadcastDriveGeometry()7/soslaves candetermine ifimagefits 

} 

// Now process the desired part of the drive, 
DisplayProcessingScreenO; 
1 5 // Get ready to start and lets start 

#if definedC IGNORE.ORIGINAL^GEOMETRY) 

CurreniCylinder = 1 + InnageFileHeader.partilionStartCylinder; 

#e]se 

CurrentCylinder = I mageFileHeadcr. parti lionSiart Cylinder; 

20 #endif 

CurrenlHead = 0; 

CompressPTR = LocalMaxSectors*5 1 2+10;// make it bigger to make 
ByiesInCompressBuffer = LocalMaxSeciors*512; 
// the program fill the buffer 
25 , //later. 
do{ 

■ ImageDataB yi e=GetB yieFromComprcssB uf fcr() ; 
if (ImageDalaByie == COMPRESSIONKEY) { 

CompressCount = GeiByteFromCompressBuffer(); 
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// unpack the two remaining 
■ImageDataByie = GetByieFromCompressBuffer(); 

// byies of compressed data 
WriicDaiaToHeadBuffer(CompressCount, ImageDataByie); 
5 • } - 

^^se ( // non compressed data 

WrileDataToHeadBuffer( 1 , ImageDataByie); 

// only one byte 

) 

10 // if(kbhit()){ 

II if (loupper(gelch()) == 'Q') 

II . CleanExitO; 

II ] ' 

} whiIe((BylesInCompressBuffer != EOF) && (ByiesInCompressBuffer > 0)); 
1 5 #if defined( IGNORE_ORJGINAL,GEOMETRY) 

inform{ stderr. "\n\nSlariCyiinder = %u\n", ImagcFileHeader.pariitionSlartCylinder); 
inform( stderr, "At end, CurrentCylindcr is %u, CurrentHead is %u\n", 
CurrentCylinder, CurrentHead); 
inform( sLderr, "PAKTC: "); 
20 ^ (void)getch(); 

inform( stderr, "\n"); 

#endif 
#ifO 

// If in broadcasi mode, send exit command 
25 -if (BroadcasiEnableFIag == TRUE) { . 

OurHeader.conunand = EXIT; 
for(i=0;i<3;i++) 

// multiple limes so were sure they gel it 
SendOurlPXPacketO; 
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) 

#endif 

// Close the image file If used 
if (ImageFileName Valid == TRUE) { 
5 if ( cIose(lmageFilcHandle)) { 

sprinif(ErrorMessage, "\nError closing image file %s", ImageFileName); 
DisplayLargeMsg(l, " Error"); 
LogError(CLOSEERR, ErrorMessage); 
CleanExitQ; 
10 ) . 

) 

if ( BroadcastEnableFlag) { 

finishBroadcastProcessingO;/* Resendany missed tracks, then 
^ ^ * say "goodbye" to the clients. 

*/ 

) 

) 

/********************************************************^ 
20 Program: GelByteFromCompressBuffer 

Description: This function retrieves a byte from the CompressBuffer. 

When the buffer is empty, ii is refilled by reading 
data from the image file. 
Author: Kevin J. Turpin Dale: 16 May 1996 
25 ************************************^^ 

unsigned char GetByteFromCompressBuffer( void) 
{ . 

// if we are empty, fill it up. 

if (CompressPTR >= BytesInComprcssBuffer) { 
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FillCompressBufferFromFileO; 
CompressPTR = 0; 

) 

return (CompressBuffer[(unsigned int)CompressPTR++]); 

Program: FillCompressBufferFromPiJe 
• Descripiion: This function fills the CompressBuffer by reading 

a head size (MaxSeciors * 512) of daia from the image 

^" ^"-^^ occurs during the read, an error 
message is displayed. 
. Author: Kevin J. Turpin Dale: 16 May .1996 

void FillCompressBufferFromFile( void) 

ByiesInCompressBuffer = read(ImageFiIeHandle, 

CompressBuffer, 
LocalMaxSectors *5 J 2); 

if(BytesInCompressBuffer = -l) ( 

20 

sprimf(EiTorMessage, ■■\nError reading image file %s". 
ImageFileName); 

LogError(READERR, ErrorMessage); 
CleanExilO; 

25 I ■ . • 

• 

' Program: WriteDataToHeadBuffer 
Description: This function takes the byie of data passed to it and 

writes it to the HcadBuffer compressCouni times. This 
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IS pari of the process of unpacking or uncompressing 
the image file (Run Length compression algorithm). 
When the HeadBuffer is full, we will flush it to the 
hard drive. 

Author: Kevin J. Turpin Dale: 1 6 May 1 996 

void WriieDataToHeadBuffer(int compressCoum. unsigned char data) 
{ 

int i; 

//Temp lest (kevin) 

if (data != HLLDATA && ValidDatalnHead != TRUE) 

ValidDatalnHead = TRUE;. 
// Put ihc data in the HeadBuffer 
for (i=0: i<compressCount; i++) { 

HeadBuffer[(unsigned int)HeadBufferPTR++] = data; 
if (HeadBufferPTR >= LocalMaxSectors*5 1 2) { 
FlushHeadBufferQ; 
HeadBufferPTR = 0; 

) 



' Program: FlushHeadBuffer 

Description: This function flushes the HeadBuffer to disk. The 
entire Head is wriien with one command. All needed 
pointers, counters, etc are updated along with screen 
info. 

Also, if the broadcast feature is enabled, we will 
broadcast the head to the slaves. 
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Author: Kevin J. Turpin Date: 16 May 1996 
Mod 1: Added check for valid data before flushing head buffer. 

Kevin Turpin 12-17-1996 
******************************^^^ 

5 void FlushHeadBuffer( void) 
{ 

// Lei the operalor knovi^ where we are 
DispIayProcDataO; 
// Now lets write the HeadBuffer to disk if it coniains valid data. 

// Note that the Force WriteData flag can override and force us to 
// always write the data. 

if ( ValidDalalnHead == TRUE H Force WriteData == TRUE) 

WriteHeadBufferToDriveO; 
/* Update "valid up to" numbers. */ 
ValidUpThruCylinder = CurrenlCylinder; 
ValidUpThruHead = CurrenlHead; 
// If in broadcast nnode. broadcast the head 
if (BroadcastEnableFlag == TRUE) { 
BroadcaslHeadO; 

) 

. // Better update pointers/counters/etc 
if (++CurreniHead > Local MaxHeads) { 
CurrentHead = 0; 
CurrentCylinder++; 
) ^ * 

ValidDalalnHead = FALSE; 
// Get ready for next head of data 

) 
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Program: WriteHeadBufferToDrive 

Description: This function writes the HeadBuffer to disk at the 
CurrentCylinder and CurrentHead. The data is then 
read back froin the drive and compared with the original 
5 data (read after write verify function). 

If errors are encountered, the process is retried 5 times 
in an attempt to recover from the error. It we do not 
recover, an error message is displayed. 
Author: Kevin J. Tujpin Date: 16 May 1996 
10 ****************************************************** 
void WriteHeadBufferToDrive( void) 
{ 

int ccode, 

• reiryCount; 
15 if ( DebugFlag == TRUE) { 

static unsigned long writeCount = OL; ' 
im x=wherex(). y=wherey(); 
writeCount++; 
goioxy('l,24); 

. . • . cprintfC'WriteHeadBufferToDrive count: %lu writeCount); 

gotoxy( X, y); 

} 

• retryCount = 0; 

do{ * . . 

25 * 11 Try to write the head 

ccode = biosdisk(WRjTE, 
CurrentHDDrive. 
CurrentHead, 
CurrentCylinder, 
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//since we read an entire head, sectors 1 
LocalMaxSeclors, 
HeadBuffer); 
if (ccode) { 

D!splayBiosError( ccode. 20, 25); 
rclryCount++; 

) 

) while ( ccode && relryCoum < 5); 

if (ccode) { //are we clean yet? No enos. 

if (ccode != Ox 11 ) ( //we can recover from CRC errors 
sprintf(ErrorlVIessage, 

■"\n\nBios error %d wriung to cylinder %d, head %d", 
ccode, 

CurremCylinder, 
*5 CurrentHead); 

l^gEiTor(BIOSERR. ErrorMessage); 
CleanExitO; * • 

) 

) 

20 // Now that we have written it to the drive, read it back and con^are 
//But we will only do this if the operator asks us to. 
if (ReadAfierWriieVerifyFlag ==TRUE) { 

ReadDnveHead(CompareHeadBuffer); 
if (memcnip(CompareHeadBuffer, HeadBuffer, LocalMaxSectors*5 1 2) != 0) { 
25 sprintf (ErrorMessage, 

"\nRead after write verify error on Cylinder %ld, Head %d'\ 

CurremCylinder, 



CurrentHead);- 
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LogError(VERIFYERR, ErrorMessagc); 
CleanExilO; 
) 

} 

5 ) ' . 

Program: CheckGeometry 
Description: This function is called by dircciion of a received IPX 

packet command, Ii lakes the geometry received in the 
' ^ IPX packet and compares it with the local drive geometry. 

If they are not the same, an error message is displayed 
and the program is terminated. 
If they are the same, ihe function returns normally. 
Author: Kevin J. Turpin Date: 6 May 1996 

void CheckGeometry( void) 
( 

#if denned{ IGNORE_ORIGIN AL.GEOMETRY) 

ImagcFileHeader.maxCylinders = LocalMaxCylinders; 
20 ImageFileHeader.maxHeads = LocalMaxHeads; 

ImageFileHeader.maxSectors = Lx)caIMaxSectors; 
return; 

#endif 

if ((ImagePileHeader.maxCylinders != LocalMaxCylinders) II 
25 (ImagePilcHeader.maxHeads != LocalMaxHeads) 11 

(ImageFileHeader.maxSeciors != LocalMaxSectors)) { 
// If the heads and sectors are the same and the image cylinders 
// is less than the local drive cylinders, we can still image it. 
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if ((ImageFileHeader.maxHeads == LocalMaxHeads) && 

(ImageFileHeader.maxSeciors == LocalMaxSectors) && 
(ImageFileHeader.maxCylinders <= Local Max Cylinders)) 
return; 

sprjnlf(EiTorMessage. "Wrong Geometry"); 

LogError(BADGEOMETRY, ErrorMessage); 

BeepO; 

BecpO; 

BeepO; 

printf("\n\nlmage geometry does not match local geometry!"); 
prinlf("\n\nCannot receive the image."); 

printf("\n\nLocal geometry == Cylinder - %d", LocalMax Cylinders); 
printf("\n Head - %d\ LocalMaxHeads); 

printf( "\n Sectors - %&\ LocalMaxSectors); 

printf("\n\nlmage geometry = Cylinder - %d", 

ImageFileHeader.maxCylinders); 
printf("\n Head - %d", ImageFileHeader.maxHeads); 

printfC"\n Sectors - %d\n\n". 

ImageFileHeader.maxSeciors); 



20 



CIcanExiiO; 



Program: Beep 



• 25 



Description: This function makes the speaker beep. 



Author: Kevin J. Turpin 



Date: 6 May 1996 




void Beep( void) 
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sound(600); 

lenthMilliDelayOOOO); 

nosoundO; 

) • • • 

5 /*************************************************;^##**^ 

Program: DisplayUsage 

Description: This function displays the usage for this program. 
Author: Kevin J. Turpin Date: 13 May 1996 

10 void DisplayUsage( void) 
{ 

clrscrO; 

primf("\nlmageBIaster version %u.%u.%u", 
• ProgramMajor Version, 
J 5 ProgramM i norVersion, 

ProgramRevision); 
phntf("\nCopyright 1996-1997. KeyLabs, Inc. All rights • 

reserved."); 
printf("\n" 
20 "\n" 

"KeyLabs, IncAn" 
"633 South 550 East\n" 
"Provo, Utah 84606\n" 
"Phone: 801-377-5484\n"); ... 
25 /* Print distributor info. */ 

decrypi_primstring( distributedBy); 
primf{"\n"); 

primf( "\nUSAGE:"); 

prinifl "\n IMGBLSTR [switches]"); 
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primf( "\n"); 

pnmf( "\nswitches = -U Upload image"); 

pnntf( "\n -D Download image"); 

pnnlf( "\n -Px Partilion to process 

5 (x=[1..4].5=emiredisk)"); 

prinif( "\n -I[y] y = Image file name 

(optional for broadcast uploads)"); 
primf( "\n -R Read after write verify 

on."); 

10 if ( BROADCAST_ENABLED()) { 

printf( "Vn -B(n) Broadcast image data to all image 

slaves"); 

printf( "\n (Optional 'n' is number of clients expected."); 

printf( "\n -BO' Disables broadcast 

15 mode.)"); 
} 

prinlf( "\n -Gz Prepare Drive (z=['A'.;Z']) 

CG'et Ready for Upload)"); 
printf( "\n -NT No physical I/O for Prepare 

20 (allows -G in NT DOS box)"); 

prinif( "\n -L Display License 

information."); 
printf( "\n"); 
/* PROGRAMMERS TAKE NOTE! The following UNDOCUMENTED OPTIONS are 
25 recognized 

* by the program but are NOT shown in the 'usage' message: 

* . * 

* -z! Turns on DebugFlag variable. 

* -db Turns on "debug broadcast" mode (DebugBroadcasi 
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variable) 

* . -m Turns on "monitor broadcast delays" mode 

* (MonitorBroadcastDelays variable) 

* -f Forces ALL data to be written to disk (*'empty" 
5 heads NOT skipped) 

* (ForceWrileDaia variable) 
*/ 

#if 0 /* This is out of place here (displaces rest of messages). */ 
. // Write Eval only copy 
1 0 WriteEvalMessageO ; 

#endif 

). • ■ 

Program: DisplayBiosError 
1 5 Description: This function displays the error message associated with 

the BIOS error (as specified in the BC library book). 
Author: Kevin LTurpin Dale: 6 May 1996 

void DisplayBiosErrortinl ccode, int x, inl y) 
20 { 

goioxy(x, y); 
switch(ccode) { 
• caseOxOp: 

cprintf( "Error %x - Operation successful.", ccode); 
25 break; 

case 0x01: 

cprintf("Error %x *- Bad command.", ccode); 
break; 

case 0x02: 
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cprintfC'Error %x - Address mark not found.", ccode); 
break; 
case 0x03: 

cprintfC'Error %x - Altempi lo write to write-protected 
5 disk.", ccode); 

break; 
case 0x04: 

cprintfC'Error %x - Sector not found.", ccode); 
break; 

10 case 0x05: 

cprintfC'Error %x - Reset failed.", ccode); 
break; 
case 0x06: 

cprintfC'Error %x - Disk changed since last operation.", 
J 5 . ccode); 

break; 
case 0x07: 

cprintfC'Error %x - Drive parameter activity failed.", 
ccode); 

20 break; 

case 0x08: 

cprintfC'Error %x - DMA overun.", ccode); 
■ break; 
case 0x09: 

25 * cprintfC'Error %x - Attempt to DMA across 64K boundary.", 

ccode); 

break; 
case OxOa: 

CprintfC'Error %x - Bad sector detected.", ccode); 
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break; 
caseOxOb: 

cprintfC "Error %x - Bad track detected", ccode); 
break; 
case OxCk:: 

cprintfC'Error %x - Unsupported track.", ccode); 
break; 
case Ox 10: 

cprintfC'Error %x - Bad CRC/ECC on disk read.", ccode); 
break; 
case Ox n I 

cprintfC'Error %x • CRC/ECC corrected data error.", ccode); 
break; 
case 0x20: 

cprintfC Error %x - ConlroJIer has failed,", ccode); 
break; 
case 0x40: 

cprintfC'Error %x - Seek operation failed.", ccode); 
break; 
case 0x80: 

cprintfC'Error %x - Attachment failed to respond.", ccode); 
break; 

case Ox A A: 

cprintfC'Error %x - Drive not ready.", ccode); 
break; 
. caseOxBB: 

cprintfC'Error %x - Undefined error occurred.", ccode); 
break; 
case OxCC: 
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cprintfCError %x - Write fauli occurred.", ccode); 

break; * 
case OxEO: 

cprintfCError %x - Status error.", ccode); 
5 break; 

case OxFF: 

cprintfCError %x - Sense operalion failed.", ccode 

); 

. break; 
10 default: • 

break; 

• 1 ' 

) . . 

15 Program: LogError 

Description: This function displays error messages passed to it from 
the calling function. It displays in large text either 
"SUCCESS" or "ERROR" depending on the error code. 
Author: Kevin J. Turpin Dale: 7 May 1996 
20 ***********************»*********#********♦*»****♦♦##*♦******* 

void LogError(ini errCode, char * errMessage) 

i 

jf (enrCode == 0) ( 

DispIayLargeMsgC I. "Success"); 
25 prinif("\n%s -> Code = %d\n", errMessage, errCode); 

'} 

else { 

DisplayLargeMsg(l, " Error"); • 

printfC\n%s -> Code = %d\n", errMessage, errCode); 
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// *cxit(0); 
) 

) 

5 Program: DisplaySlaiicScreenDaia 

Description: This function displays the sialic portion of the screen 
text. 

Author: Kevin J. Turpin Date: 7 May 1996 

10 void DisplayStaiicScreenDala( void) 
{ 

inli; . * * 

int originalColor = Text_Color( LIGHTGRAY); 

// Display the static portions of the screen 

15 for (i=l; i<MAX_.STA'nC_SCREEN_DATA; i++) { 

if ( f SiaiicScreenDatal i].broadcaslReiaied 

II BroadcastEnableFlag == TRUE) ( 
goioxy(SiaticScreenDaiaIiJ.x. 

SiaiicScreenData[i].y); 
20 ■ cprintf("%s". StaticScreenData[i].Text); 

) : 

} ■ 
if (DebugFlag == TRUE) ( 
goioxy(63, 18); 
•25 cprintfC'DebuglnfoV); 

gotoxy(63, 19); 

cprintfC— - -"); 

goioxy(59, 20); 
cprintfC'CK FD CC"); 
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cprintfC "); 

} 

TexLColor( original Color); 
5 ) ■ . 

Program: CleanExii 
Description: This function puts the computer back into the proper state 
before exiling. This includes: 
^ 0 - Changing text color back to normal 

- Freeing any allocated memory 

- exiting 

Author: Kevin J. Turpin Date: 7 May 1996 

15 void CleanExii( void) 
{ 

// Change lext back to normal 
Text_Color(LIGHTGRAY); 
// Free any allocated memory 
20 DeallocateBuffersO; 

#if 0 /* Commented-out 1/8/1 997 by Chris Clark: Causes 
* slaves to get hosed. 

-*/ ■ ' ■ ' . 

// Ifwe arein broadcastmode, send an exit packet to tell slaves bye bye 
25 , if (BroadcastEnableFlag==TRUE) { 

OurHeader.conimand=EX]T; 
SendOurlPXPackelO; 
) ... 

#endif 
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/* Cancel listen packets. */ 
if ( BroadcasiEnableFlag == TRUE) { 
ShutdownBroadcaslQ; 

) 

5 7* Close our local socket, if open. */ 

if ( LocalSockei != 0) { 

IPXCloseSockct( LocalSocket); 

} 

//Now lets exit 
10 exii(-l): 
) 

/******************************^^^ 
Program: DisplayLocalGeoinetry 

Description: This function displays the local drive geometry. 
Author: Kevin J. Turpin Dale: 7 May 1996 

. void DispIayLocalGeomeiryC void) 

{ ' • 

ini originalColor = Text_Color( WHITE); 
20 goioxy(DynamicScreenData[LOCALCYL].x, 

DynaniicScreenData[LOCALCYL].y); 
cprimf("%#4d", LocalMaxCylinders); 
goioxy(DynamicScreenData[LOCALHEAD).x, 

DynamicScreenDaia(LOCALHEAD].yy; 
25 cpnnif("%#4d\LocalMaxHeads); 

gotoxy(DynamicScreenData[LOCALSECT].x, 

DynamicScreenDaia[LOCALSECT].y); 
cprintf("%#4d", LocalMaxSeciors); 
Text_Color( originalColor); 
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Program: DisplaylmagcGeomelry 
Description: This function displays the Image geometry. It also displays 
5 the processing stop or end geometry 

Author: Kevin J. Turpin . Date: 7 May 1996 

void DjsplayImageGeomeiry( void) 
{ 

10 int originalColor = Texi_Color( WHITE); 

goioxy(DynamicScreenDatafMASTERCYL).x, 

DyriamicScreenDatafMASTERCYLJ.y); 
. cprintfr%#4d",LocalMaxCyiinders); ' 
goioxy{DynamjcScreenDaia[MASTERHEAD).x, 
15 DynamicScreenData[MASTERHEAD].y); 
cprinif("%#4d", LocailVlaxHeads); 
gotoxy(DynannicScreenData[MASTERSECT].x, 

DynamicScreenDaia[MASTERSECT].y); 
cprinif("%#4d". Local MaxSeciors); 
20 // Now display the ending geometry 

Text.ColordJGHTGRAY); // so ii doesn't stand out 

gotoxy(DynamjcScreenDaia[STOPCYL).x, 

Dy namicScreen Data[ STOPCYL) . y ) ; 
if (DownloadFlag == TRUE) // get end cylinder from image file 
2^ cprintf("%#4d", ImageFilcHeader.parlilionEndCylinder); 

else 

'cprinif("%#4d", Parliiion|PariiiionNumber).endCyHnder): • 
gotoxy(DynamicScreenData[STOPHEAD].x, 

DynamicScreenData[STOPHEAD].y); 
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cprimf("%#3d", LocalMax Heads); 
goioxy(DynamicScreenDaiafSTOPSECTJ.x, 

DynamjcScreenData[STOPSECT].y); 
cprinifC'%#3d'\ LocalMaxSectors); 
5 TexLCo!or( originalCoIor); 

) 

/************************.**^^^^ 

Program: DisplayProcDaia 
Description: This function displays the processing data. This includes 
' ^ the current Cylinder, Head, and Sector. 

Author: Kevin J. Turpin Dale: 7 May 1996 
*-********-****************^^^^^ 
void DisplayProcData( void) 
I 

originalColor = Text_CoJor( WHITE); 
goioxY(DynamicScreenDatafPROCCYL].x, • * 

DynamicScreenDatafPROCCYLJ.y); 
cprintf(-%#4d %#3d %#3d", CuiTcnlCylinder, 

CurrentHead, 
CurreniSector); 
// gotoxy(DynamicScreenData[PROCHEAD].x, 

t)ynamicScreenData[PROCHEAD].y); 
// cprintfr'%#3d". CurrentHead); 

// . ' * • . 

25 // goioxytDynaniicScreenData[PROCSECT].x. 

I>ynaniicScrcenDaia(PROCSECT].y); 
// cprinlf("%#3d", CurrentSector); 
TexLCo]or( originalColor); 

) 



20 
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Program: DisplayLocalMAC 
Description: This funciion displays the MAC address of the local 
computer. 

li also displays the image file name. 
Author: Kevin J. Turpin Date: 7 May 1996 

void DisplayLocalMAQ void) 
I 

int originalColor = text.Color( WHITE); 
gotoxy(DynamicScreenDaia[LOCALlyiAC).x, 

DynamicScreenData[LOCALMAC].y); 
sprintf(TmpBuffer, "%2.2x%2.2x%2.2x%2.2x%2.2x%2.2x\0'\ 

NetAddressf4]. 
. NetAddress[5], 
NetAddress(6], 
NetAddress[7], 
NetAddressfS], 
NetAddress(9]); 

20 TmpBuffer[12J.= NULL; 

cprintf("%s", TmpBuffcr); 

// Now dispiay the image file name 

gotoxy(DynamjcScreenData[IMAGEFILE].x, 

DynamicScreenDatallMAGEHLEJ.y); ' * 

25 if (ImageFileNameValid == TRUE) 

cprintf("%s", ImageFileName); 

else 

cprimfC'None"); 
Text_CoIor( originalColor); 



15 . 
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) 

Program: DisplaySocketNumbers 
Description: This function displays the socket numbers for the broadcast 
5 function. 

Author: Kevin J. Turpin Date: 7 May 1996 

void DisplaySocketNumbers( void) 
{ 

10 if ( BroadcastEnableFlag == TRUE) { 

ini originalColor = Texi^ColorC WHITE); 
gotoxy(DynamicScreenDaia[SENDSOCKET].x, 

• DynamicScreenData[SENOSOCKET].y); 
cpri ni r( " %x " , DOWNLO AD_SOCKET_NUMBER) ; 
1^ - . goloxy(DynamicScreenData[RECVSOCKET].x, 

' DynamicScreenData[RECVSOCKET].y); 
cprintf("%x". SWAP_WORD( LocalSocket)); 
Tcxi_Color( originalColor); 



} 



20 



Program: Prepare Drive WORKER 
Description: This function actually does the work of preparing a drive. 

(Whereas the PrepareDrive() function asks the user which 
2^ drive and then calls this function with an appropriate 

parameter). 

This function prepares the hard drive for upload by 
writing data to the unused portions of a partition 
(drive or logical drive). This is done by opening 
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a file and writing data lo it until the operating 
sysienn says there Is no more room. We then close the 
file and delete il. 

This mechanism allows the operating system to handle 
all the details about where the unused portion is. 
Author: Kevin J. Turpin Dale: 16, Oct 1996 

void PrepareDriveWorker( char driveChar) 

{ ' 
Freespacelnfo^i DriveSpacelnfo; // chris' structure def 

struct dfree Dfreelnfo; 
iong availableSpace; 
long KCount = 1 ; 

•ong number4KBIocks; 
im i; 

ccode; * 

int drive; 

fileHandle; 
char rilename[80]; 
/**Fill the buffer that will be written to the drive in large chunks **/ 
for (i=0; i<4096; i++) { . 

FilIData[i] = HLLDATA; 

) 

/***** Build the path for the file thai will prepare the drive ****/ 

drive = driveChar - 'A'; . * • 

sprinifCfilename, "%c:\\prepare.drv'\ driveChar); 
printf("\nFile name = %s*',filename); 

/***♦ We rnusi figure out how much space is on the drive to prep *****/ 
jj^jg ^jij ^^^^ j.^^ making the proper bar graph. ****/ 
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i.f(NTFIag==TRUE){ 

/* We must AVOID physical disk I/O since we may be running 
* an NT DOS BOX which disallows any physical disk I/O. 
*/ 

5 geldfree(drive+l, &Dfreelnfo); 

/* Calculate freespace based on logical information. */ 
availablcSpacc = ( (long) Dfreelnfo.dLbsec 

* (long) Dfreelnfo.dLsclus 

* (long) DfreeInfo.df_avail); 
1 0 #if PRJNT.FREESPACE^AND.EXIT 

prinlf("\n\n" 

"byies/seci = %lu\n" 
"sect/cluster = %lu\n" 
"avail clust = %lu\n" 
"availableSpace %lu (sig %ld)\n", 
(long)Dfreelnfo.df_bsec, 
(long)DfreeInfo.df_scIus, 
(long)Dfreelnfo.df_avail, 
availableSpace, 
availableSpace): 
exit( 0); 

#endif /* PRINT_FREESPACE_AND_EXIT */ 
} 

else ( 

5 • ccode = geLfreespace(drive. &DriveSpacelnfo); 

if (ccode != 0) { 
printf("\n\nError getting drive space info, (enror %d)\n", ccode); 
primf("\n\nDRIVE MAY NOT EXIST!\n\n"); 
exit(l); 
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) ... 

/* Catculare freespace based on physical information. */ 
availableSpace = ( (long) DriveSpace! nfo.bylesPerSector 
* (Jong) DriveSpacelnfo.sectorsPerCluster 
5 * (long) DriveSpacelnfo.freeClusters); 

) 

number4KBlocks = availableSpace / 4096; 

/*♦** pj.^p jj^g ^^jyg opening a file on the drive and *****/ 

/**♦* filling it until we run out of room. *****/ 
10 printf("\n\n"); 

(void)unlink(rilenanie); 
it already exists 

if ((fiieHandle = opcn(filename, 0_RDWR I O.CREAT \ O^BINARY, 

SJREAD I S.IWRITE )) == -1) j 
^5 printf("\n\nError opening %s", filename); 

exii(l); . 

) ■ . 

/** We are now ready to prepare the drive, lets draw a bar graph ****/ 
clrscrO; 

20 _setcursortype(_N0CURSOR); // turn cursor off 

DisplayLargeMsg(K " Preparing"); 
gotoxyOl.lO); 

cprintfC'Preparing Drive %c'\ driveChar); 
goioxy(28,12); 

25 cprimfC'Available Space -%ldK",availableSpace/1024); 
// Wriie Eval only copy 
WriteEvalMessageO; 

DrawBarGraph(O); // 0 = new bar graph 

while ((wrile(fileHandIc, FillDaia, 4096)) -= 4096) { 
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KCounl = KCounl++; 

DrawBarGraph((int)({( KCount - 1 )* 1 00) / number4KB locks)); 
) 

We are now done preparing the drive ****/ 
5 . Now close the file and delete it! *****/ 

. if( close(fileHandle)) ( 

^setcursortypeLNORMALCURSOR); // turn cursor back on 

printf("\n\nError closing %s\ filename); 
exil(l); . 

10 ) ' 

if ( unlinkCfilename)) { 

^setcursortype(_NORMALCURSOR); // mm cursor back on 

prinif("\n\nError removing %s'\ filenarhe); ' 
exit(]); 

15 } 

_setcursortypeLNORMALCURSOR); // lurn cursor back on 
) • 

/****************************#******************************* 
Program: Prepare Drive 
20 Descripiion:Prompt user for a drive letter, then call 

PrcpareDriveWorkerOto actually do the work. 
Author: Kevin J. Turpin Date: 16, Oct 1996 

void PrepareDrive( void) 
25 { • 
char driveChar; 
. clrscrO; 

• prinif("\n\nPleasc enter drive letter to prep (A-Z) : "); 
// Wriie Eva I only copy 
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WriteEvalMessageQ; 

driveChar = toupper(geich()); 

if ((driveChar < 'A') II (driveChar > T))* { 

printf("\n\nYou entered an invalid drive letter!*'); 
5 exit(l); 

) , 
PrepareDriveWorker( driveChar); • 

} 

10 Function: DrawBarGraph(int PercentComplcted) 

Description:This ftinction displays a bar graph with a % completcdnumber. 

Author: Kevin Turpin Dale: 16 

Oct. 1996 ^ 

Modifications: 

void DrawBarGraph(ini Perce niCompleled) 
{ 

im i; 

ini originalColor = Tcxl_Color( UGHTGRAY); 
20 // gel to the right place on the screen 

gotoxy(16,18); 

// if % completed = 0, then draw a clean bar graph 
if (PercentCompleted ==0) { 

for (i=0; i<50; i++) ( 
25 cprintf("%c'\ OxBO); // empty box = OxBO 

) 

) * 

// if other than 0, draw one box for each 2% 
else ( 
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Texi_Color(YELLOW); 

for (i=0; i<(PercentCompletecl/2); { 

cprinif("%c",219); //filled box = 219 dec 



// now go 10 the righl place lo display the % value 

TexLCoIorCLlGHTGRAY); 

goioxy(33,20); 

cprintf("%3d% Completed", PercentCompleted); 
10 TexuColor( originalCoior); 

) 

Function: WrileEvalMessage 
Description: This function displays an Evaluation Message to inform 
15 the user that this copy of the utility is an Eval only 

copy. This message is only displayed if the 
evalProgram flag is set. 

Author: Kevin Turpin Date: 30 

Oct, 1996 
20 Modifications: 

void WriteEvaIMessage( void) 

{ * . 

// Find out if we should display this message 
25 ' if ( evalProgram) { . . * 

int xcord, ycord; 

int originalColpr = Texl_Color( WHITE): 
. // Write Eval only copy 
xcord = wherexO; 
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ycord = whereyO; 
goioxy(45,23); 

cprinifC'*** For Evaluation Purposes Only ***"); 
go!oxy(48,24); 

5 ' cprintfC'*** Not For Production Use ***"); 

Text_Color( originalColor); 
gotoxy(xcord,ycord); 

. } ' 

) 

Function: ' DeterniineNumbcrOfHardDrives 
Description :This function checks to see how many hard drives are in 

the computer. A default of one hard drive is assumed. 
This function checks for a second hard drive by 
15 • trying to read a section (sector) from the second drive. 

If it is successful, a second drive exists. If it fails, 
the default of one drive is used for the number of hard 
drives in the computer. 
Author: Kevin Turpin Date: 30 Oct, 1996 

20 Modifications: 

*:^4e***«**4e****4c*****4f9|(*9i:4'**4c***3fc**4c ********* A'lE**^^**** 

void DeteniiineNumberOfHardDrives( void) 

I. . 
int i, 

25 . ccode; 

// We will loop four times to check all IDE possibilities 
// Two drives on primary channel and two on secondary 
// We do this in case there are two drives on seperale channels 
for (i=0; i<4; i++) | 
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// Try to read a sector from the second drive 
ccode = biosdisk(READ, 
■ 0x80 + i, 

0, * . 
0. 
1, 
1, 

HeadBuffer); 
if (DebugFlag = TRUE) { 

printf("\nJust tried to check drive ID %x", 0x80 + i); 
printf("\nccode = %d". ccode); 

prinif("\nPress any key lo continue "); 

getchO; 

} 

// if successful, number of hard disk drives = 2 
if (ccode == 0) { 

if (DebugFlag = TRUE) ( 

pr!ntf("\n\nl think I found a drive at %x", 0x80 + i); 



// drive 
// head = 0 
// cylinder = 0 
// sector=l 

// read only one sector 



20 //Before we assume this is a hard drive, lets try to write the data back 
// to it to verify that ii is noi a CD drive on the same channel, 
ccode = biosdisk(WRITE, 

0x80 + i. 

0, 

25 0, ' • 

1, 

HeadBuffer); 

if (ccode == 0) { // No errors, ii was a hard drive 



// drive 

// head = 0 
// cylinder = 0 
// sectors 1 

// write only one sector 
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if (DebugRag == TRUE) \ ' ' 

prinif("\n\nl did find a drive ai %x", 0x80 + i); 
1 . . 

NumberOfHardDrives++; 
5 HardDriveID[il = TRUE: 

// save off id number 

if ( DebugFlag == TRUE) { 
printf('An\iiFOUND a SECOND HARD DRIVE with id 0x%02x. Not looking 

for moreAn", 
10 0x80 +i); 

printf("Hit any key to continue..."); 

(void)geich(); 

prinlf("\n"); 

break; 

15 



Function: AlIocateBuffers 
Description: This function allocates the needed buffers for the 

progrann. These buffers are used for reading and 
writing to the hard drive. 
25 Author: Kevin Turpin Date: 30 Oct, 1996 

Modifications: 

void Allocates uffers( void) 
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// Allocate memory for Head buffer, compare buffer, compress buffer 
if {(HeadBuffer = (unsigned char *) ca!loc((512*LocalMaxSeclors), 

S!zeof(char))) = NULL) ( 
sprinlf(ErrorMessage, "Not enough memory to allocate Head buffer !\n"); 
5 LogErTor(ALLOCERR. ErrorMcssage); 
CleanExitO; 
) 

if ((CompareHeadBuffer = (unsigned char *) caIloc((5 1 2*LocaIMaxSectors), 

sizeof(char))) NULL) ( 
10 sprintf (ErrorMcssage, "Not enough memory to allocate Compare Head 
buffer!\n"); 
LogEnor(ALLOCERR, ErrorMcssage); 
CleanExitO; 
) 

15. if ((CompressBuffer = (unsigned char *) calloc((5 1 2*LocalMaxSeclors). 

si2eof(char))) == NULL) { ' 
sprintf(EiTorMessage, "Not enough memory lo allocate Compress 

buffer!\n"); 
LogError(ALLOCERR. ErrorMcssage); 
20 CleanExitO; 
) 

) 

Function: DeallocateBuffcrs 
25 'Description: This funciion deallocates ihe buffers used in the 

program. 

. Author: Kevin Turpin Date: 30 Oct, 1996 

Modifications: 



wo 98/50874 



PCT/US98/09018 



154 

void DeallocateBuffersC void) 
( 

if(HeadBuffer \= NULL) 
free(HeadBuffer); 
5 if (CompareHeadBuffer != NULL) 

free(CompareHeadB uffer); 
if (CompressBuffer !=NULL) 
free(CompressBuffer); 
) • . 
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#define KEY^ENABLE^DEBUG 1 ./Pluses '(»• key to toggle DebugBroadcast mode. */ 
#undef BEAUCOUP_VERBOSE /* Causes VERBOSE packel-processing outputs. */ 

* (C) Copyright 1996-1997 KeyLabs, Inc. 

* All Rights Reserved. 

* This program is an unpublished copyrighted work which is proprietary 

* to KeyLabs. Inc. and contains confidential information that is not 

* to be reproduced or disclosed to any other person or entity without 

* prior written consent from KeyLabs, Inc. in each and every instance. 

* WARNING: Unauiorized reproduction of this program as well as 

* unauthorized preparation of derivative works based upon the 

* program or distribution of copies by sale, rental, lease or 

* lending are violations of federal copyright laws and state trade 

* secret laws, punishable by civil and criminal penalties. 

Program: IMGSLAVE.C 

Description: This program is the slave component of the parallel disk 

image process. This slave uses an IPX socket to listen 

for data from the image master. A special header in this 

data determines the function the slave will perform. 
Author: Kevin J. Turpin Date: 6 May 1996 
Mod 1: Added support for multiple receive ECBs. Kevin 5 Dec 1996 

#denne ' NWDOS 
#include <asseri.h> 

#include <stdio.h> . 
#include <sidlib.h> 
#include <stddef.h> 
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#jnc!udc <stdarg.h> 
#include <siring.h> 
^include <conio.h> 
#include <dos.h> 
5 #include <dir.h> 
#include <alloc.h> 
#inc)ude <bios.h> 
#include <limc.h> 
^include <mem.h> 
10 #incliide <fcnil.h> 
#include <sys\stai.h> 
^include <io.h> 
^include <process.h> 
#inciude <nwipxspx.h> 
15 #include "imgsJave.h" 
#include "largemsg.h" 
#include "esr.h" • 
#include "eval.h" 
#include "license.h" 
20 /**************************************************** 

// The next #derjne*s are for conirolling how the program works for 
// debug, normal. If the #defme DEBUG is uncommented, various debug 
// messages will be displayed during execuiion. 
25 //#derme DEBUG . • - i 

// end of special ^define's 

/* Make sure ihis program has plenty of stack space 
* (the default is something like 4K). 
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*/ 

unsigned _stklen = 1 6384; 

/* Space for the License information:'*/ 
5 ^include "crypchar.h" /* Get CRYPT...() macros and decrypLprintstringO proto. 

*/ 

#derjne DISTRJB_BY_STRING \ 
CRYPT_16( T)', r, 's\ T, 'b\ 'u', r, 'e\ 'd\ ' V, y, r, ' 0 
char disiribuledByl] = { 
10 D]STRIB_BY_STRJNG» 

CRYPT_40( 'K\ 'e\ 'y', "L*. 'a', 'b\ 's', ',\ ' T. \ 

•n'/cy.'/\ . . • 

.................... ^ 

.............. 

15 .'0 /* NUL-ierminator. */ 

); 

#defme TRUE I 

#define FALSE 0 
20 , #define WRITC . 3 

#dennc READ 2 

#definc ENDOFFILE OxFF 

#derme HD^DRIVE 0x80 • 

#define IPXOPENSOCKETERR -I 
25 #defme ALLOCERR -2 * 

^define BIOSERR . . .3 

#derine SECTORERR -4 

#define BADGEOMETRY . -5 * 

#derme VERJFYERR -8 
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#define INCOMPLETE 

#define ADD 

#define NEW 
ttdefine * OLD 

5 ^define CLEAR 

#define TEST 

#derine INITIALIZE 

#define INCOMPLETE_HEAD 

#define COMPLETE_HEAD 

10 #define NUMBER^CBs 65 



// consianls for passing options 
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-9 
1 
2 

3 
4 
5 
6 
7 
8 

/* One per sector, plus one more so we can 

* receive an entire head plus the "exit" 

* command (in finish phase). 



15 /* Handy macros. */ 

#define ASSERT( x) assert( x) 



/A DECLARATIONS 

#include "prog_id.h" 

20 static unsigned ini ProgramID = 

IMAGESLAVE.ID; /* From prog^id.h */ 

sialic unsigned int ProgramMajorVersion = 1 ; 

static unsigned ini ProgramMinorVersion = 2; 

sialic unsigned ini ProgramRe vision = 4; 

25 static im evalProgram = 0; /* Set when only license is cval. */ 

int .socketOpen = 0; 

WORD LocalSockei = SWAP^WORD( DOWNLOAD_SOCKET_NUMBER): 

IPX Address server Address; 

ECB receiveECB[NUMBElLECBs]; 
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.^v.. , 159 
IPXHeader receiveHeader[NUMBER.ECBs]; 

BufferPackeiHeader *pOurHeader; 
BYTE NelAddress[12], 
IPXDalaBuffer|NUMBER^ECBs]f51 2+sizeof{ *pOurHeader)]; 
5 inl i. 

value, 

HeadCompIeie = TRUE, 
MaslerMACFound = FALSE. 
ImageGeometryFound = FALSE. 
1 0 DebugBroadcast = FALSE; 

enum { 

STATE_F1ND^MASTER, 
STATE_READY. 
STATE^RECEIVING, 
15 STATE.RNISHING, 

STATE_DISCONNECT 
) programSiaic; 
inl LocalMaxHeads, 

LocalMaxCylinders, 
20 LocalMaxSectors. 

LocalNumHeads, 
LocalNumCylinders, 
LocalNumSectors. 
LastRecvdSector = 0, 
25 IHCouni = 0; . 

long SiariCyiinder; /* First and last cylinders in the image. */ 
Jong EndCylinder; 
char ErrorMessage[80]; 
unsigned char * CompareHcadBuffer; 
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typedef siruci ICHeads 
{ 

int head; 
long cylinder; 
5 struct ICHeads *next; 

) ICHEADLIST, *ICHEADPTR; 
ICHEADLIST *FirstICHead. *LastICHead; 
typedef siruci { 

long cylinder; 
10 longhead; 

BYTE *sectorMap; 
#define SLOT^EMPTY 0x00 
#derine SLOT„VAUD_DATA 0x01 
BYTE *sectorE>ata; 
15 } TrackBuffer; 

#defjne NUM_TRACKBUFS 1 

typedef struct { 

long cylinder; 
20 longhead; 
) TrackSpec; 

int 

CHEqual( lone cyll, long headl , 
25 long cyl2, long head2) 

{ • 

return (cyll == cyl2 &,& headl == head2); 

} 
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tnt 



CHIessThan( long cyl 1 , long headl , 
long cyl2, long head2) 



remrn( (cyll <cyl2) 

II ( cyll ==cyl2 
&& headl <head2)); 



} 



10 struct DynamicScreenType 

im x; 
int y; 



15 



to 



) DynamicScreenData(] = 


{{24, 3+8), 


//Local MAC addr 






( 65. 3+8), 


//Masier MAC addr 






{ 24, 7+8}. 


//Local Cy) 






{ 24, 8+8). 


//Local Head 






I 24. 9+8). 


//Local Sector 






1 64. 7+8), 


//Image Cyl 






1 64. 8+8), 


//Image Head . 






{64, 9+8). 


//Image Sector 






{ 29. 15+7). 


//Proc Cyl 






{40,15+7), 


//Proc head 






{49. 15+7)); 


//Proc sector 


ttdefine 


LOCALMAC 


0 




#define 


MASTERMAC 


I 




#dcfine 


LOCALCYL 


2 




#defjne 


LOCALHEAD 


3 




#derine 


LOCALSECT 


4 
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#define MASTERCYL 5 
^define MASTERHEAD 6 
^define MASTERSECT 7 
#define PROCCYL 8 
5 #define PROCHEAD 9 
^define PROCSECT JO 

#define NUM_DYNAMIC^SCREEN^DATA ( si2eof( DynamicScreenData) / sizeof( 
DynamicScreenType)) 
struct StaticScreenType 
0 { 

int x; 
im y: 

char * Text; 

) StaticScreenDaia[) = H 33, 1+8, "i M G S L A V E"}, 
5 ( 5, 3+8, "Local MAC Address"), 

{ 45, 3+8, "Master MAC Address"}, 

i 10, 5+8, "Local Drive Geometry"), 

{ 50, 5+8, "Image Drive Geometry"), 

I 10, 6+8." 

> {50,6+8," "I, 

1 13, 7+8, "Cylinders"). 
{ 53, 7+8. "Cylinders"), 
{ 13, 8+8, "Heads"), 
I 53, 8+8. "Heads"), 
.{ 13. 9+8, "Sectors"), 
I 53, 9+8, "Sectors"), 
{ 34, 11+7, "Processing"), 
{ 34, 12+7.". — - — "), 
{ 27, 13+7, "Cylinder"), 
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{27.14+7," 

{ 39, 13+7. "Head"}, 
{ 39, 14+7, "™"). 
( 47, 13+7, "Sector"). 

5 (47, 14+7, " ") ); 

#define NUM_STAT1C_S GREENED ATA ( sizeof( StaiicScreenData) / sizeof( struct StaticScreenType)) 

// Function Declarations 

void lnitialize( void); 

void GetDriveGeometry( void); 
1 0 void CheckGeometry( GeometryPacket *pGeom); 

void Beep( void); 

void Disp!ayUsage( void); 

void DisplayBiosError(im ccode, int x. int y); 

void LogError(im errCode, char * errMessage); 
15 void DisplayStaiicScreenDaia( void); 

void ClcanExiU void); 

void DispIayLocaIGeomelry( void); 

void DisplayImageGeometry( GeometryPacket *pGeom); 

void DisplayProcDataC long cylinder, long head, long sector); 
20 void DispIayMasierMAC( ECB far *ecb); 
void DisplayLocalMAQ BYTE *netAddr); 
void WriteEvalMessage( void); 

/* Inform for DEBUG-BROADCAST mode only. */ 
25 void ' 

DBJNFORM( char *formal, ...) 
•{ 

sialic im line = 1; 
ini X, y; 
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va_Jist args; 

if ( DebugBroadcasl) { 

X = wherexQ; 

y = whereyO; 
5 lextcolor(LIGHTGRAY); 

goioxy( 1, line); 

cIreolO; 

va_slart( args. formal); 
vprinif( format, args); 
10 fflush( stdoui); 

iine++; 
if(line>7){ 

line = 1 ; 

) 

^5 goloxyC IJine); 

clreolQ; /* Clear NEXT line. */ . 

goioxy( X, y); /* Restore original cursor */ 

lextcolor(WHJTE); 

) 

20 ) ■ . 

/* Shim function to Display a "LargeMessage" at the top of the screen 
* without disrupting the currem cursor position^ 

. 

25 void 

. TopLargeMsg( ini clearScreenFlag, char *msg) 
{ * • 

ini X = wherexO; 
ini y = WhereyO; 
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goioxy{l,l); 

DisplayLargeMsgC clearScreenFlag, msg); 
goioxy( X, y); 

void 

inform( FILE *oulpui„stream, char *format, ..,) 
{ 

va_lisi args; 
JO va_stari{ args, format); 

vfprimf{ ouiput_sireain, format, args); 
fflush( ouiput_stream); 

1 . \ 

1 5 /* Wail for a packet to be received on the given socket. 

* If lerminateOnKeystroke is nonZero, we return nonZefo when THAT key is pressed. 

* If timeoutTicks is nonZero. we return nonZero when that many ticks have 

* elapsed. 

* Otherwise, we wait for a packet to be received, and return ZERO 
20 . * when the packet is successfully received. 

*/ 
ini 

waiiForPacket( ini lerminateOnKeystroke, [ 
clock_i timeoutTicks, 
25 WORD socket, 

int fragCount, 
ECBFragment *frags, 
BYTE *ccode) . 

{ 
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ECB receiveECB; 
inl frag; 

clock.t endTime = (timeoutTicks 0).? 0 : clock() + timeouiTicks; 
receiveECB. ESRAddress = NULL; 
5 receiveECB.socketNumber = socket; 

receiveECB. fragmentCount = fragCounl; 
for ( frag = 0 ; frag < fragCount ; frag++) { 

receiveECB.fragmcritDescriptor[ frag).address = frags[ frag].address; 

receiveECB. fragmemDescripior[ fragj.size = fragsf frag].size; 

10 } 

IPXLisienForPackeK &receiveECB); 

/* Wait for a packet lo come in. or, opiionally, 

* a keypress, or, optionaJly, 

* a timer expiration. 
15 */ 

while ( I) { 

IPXRelinquishControlO; 

if ( receiveECB.inUseFlag == 0) { 

/* Got a packet. Return ZERO. */ 
20 *ccode = receiveECB. compIeiionCode; 

return 0; 

) 

else if ( terminaieOnKeystroke && kbhit()) ( 

/* Key was pressed. Cancel the listen then 
15 . ' * gobble keystroke(s) and return nonZero. 

*/ 

inl choice = geich(); 
if ( choice ==0){ • 

/* two-characicr keystroke. */ 



wo 98/50874 



PCT/US98/09018 



. 167 

(void)getch(); /* Throw away second byie - don*t match 2-char keys. */ 
) 

else if ( choice = lerminateOnKeystroke) { 
IPXCancelEventC &receiveECB): 
return 1 ; /* Return nonZero: key was pressed and NO packet received. */ 
) 

#if derined( KEY_ENABLE^DEBUG) 

else if (choice == '@') { 

if { DebugBroadcasi != TRUE) { 

DebugBroadcasi = TRUE; 

DBJNFORM( "DebugBroadcasi Enabled.V)"); 

) 

else { 

DB JNFORM( "DebugBroadcasi Disabled.\n*'); 
DebugBroadcasi = FALSE; 

) 

1 

#endif 

) 

else if ( limeoutTicks && ( clock() > endTime)) { 
/* Clock timeom. Cancel ihe listen then 

* return nonZero. 

*/ . 
IPXCancelEventC .&receiveECB); 

return 1 ; /* Return nonZero: timeout and NO packet received. */ 

) 

) 

) 
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/* Send an RSVP packet lo ihc server. 
* Return ZERO on success. nonZero on failure. 
*/ 

5 BYTE ■ 

sendRSVPPacketC void) 
I 

ECB sendECB; 
IPXHeader header; 
10 RSVPPacket rsvp; 

ini transporlTime; 
/* Fill in the RSVP packet data 
*/ 

rsvp.command = RSVP; 
15 /* Fill in the IPX packet header */ 

memmove( &header.desti nation, 
&serverAddress, 
sizeof( server Address)); 

header.packetType = 4; 
20 /* Fill inlhe ECB. */ 

sendECB. ESR Address = NULL; 

sendECB .sockeiNumber = LocalSockei; 
• sendECB. fragmentCount = 2; 

sendECB.fragmentDcscriplor(0].address = &header; 
25 sendECB.fragmeniDescriplor[0].size = sizeof( header); 

sendECB. fragmentDescripior[ 1 ). address = &rsvp; 

sendECB.fragmentDescripiorlll.size = sizcof( rsvp); 

if ( IPXGciLocalTargeK (BYIE far *)&scrverAddress, 

sendECB . i mmedi ale Addres s, 
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&iransportTime)) { 



return Oxlf; 



/* Error. */ 



5 



/* Send the packet. */ 



IPXSendPacket( &sendECB); 



while ( sendECB.inUseFlag) { 



IPXRelinquishControlO; 



10 



return sendECB.connpletionCode; 



/* Send a "fare thee well'* packet to the server. 
* Return ZERO on success, nonZero on- failure. . 
15 */ 

BYTE 

sendFarewellPacket( void) 
1 

ECB sendECB; 
20 IPXHeader header; 



FarewellPackei packet; 



int transportTime; 



/* Fill in the packet data 



*/ 



25 



packei.command = FAREWELL; 



/* Fill in the IPX packet header */ 



nncminove( &hcader.dc5tination, 



&server Address/ 



si2eof( serverAddress)); 
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header.packetType = 4; 
/* Fill in the ECB. */ 
sendECB .ESR Address = NULL; 
sendECB.socketNumber = LocalSockei; 
sendECB. fragmentCoum = 2; 
sendECB lragmenlDescriptor[0]. address = &header; 
sendECB. fragmentDescripior[0]. size = sizeof( header); 
sendECB. fragmentDescripior[ 1 j.address = Apacket; 
sendECB. fragmentDescriptor[l]. size = sizeof( packet); 
if { IPXGetLocalTarget( (BYTE far *)&serverAddress, 
sendECB. immediate Address, 
&transportTime)) { 
return Oxff; /* Error. V 

] 

/* Send the packet. */ 
IPXSendPacket( &sendECB); 
while ( sendECB.inUseRag) ( 

IPXRelinquishControlO; 

1 

return sendECB. compIeiionCode; 

) 

/* Wait for geometry packet, send back "rsvp" packet, 

* then wait for "rsvp ACK" packet. 

* ' ' 

* Return ZERO if we get the ACK. Return nonZero if we receive an 

* unknown packet. (We expect both GEOMETRY and "RSVP^ACK" packets.) 
*/• 

int 
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rcgisierWithScrver( void) 
{. 

ECBFragmenl rxFrags[ 2] = { 

I &receiveHeader[ 01, sizeof( receiveHeader[ 0]) ), 
I IPXDaiaBuffer[ 0]. sizeof( IPXDaiaBuffer[ 0]) ) 

): 

BYTE ccodc; 

GeometryPacket *geomPackei; 
while 

/* Wait for a packet. */ 

if ( waitForPackeK 1 , /* Tenninate on -A (coniroJ-A) keypresses. */ 
0, /* Don'i timeout based on ihe clock. */ 
LocalSockei, 
2, 

rxFrags, 
«&ccode) != 0) { 
/* No packet received: key was pressed instead. */ 
• inform( siderr, "\nGeometry-packet wait cancelled by keypressAn"); 
exit( 1); 

) 

/* Got a packet. Check the completion code. */ 
if(ccode)( 

inform( sideiT. "\nPackei reception error: ccode Ox%x\n'\ (Oxff & ccode)); 
exit( 1); 

) 

/* Packet received OK. Get the header. */ 
geoniPackei = (GeometryPacket *)IPXDataBuffer[ 0]; 
switch( geomPackei->command) { 
case GEOMETRY: 



wo 98/50874 



PCTAJS98/09018 



172 

/* Save the server address. */ 
menimove( &serverAddress, 

&(receiveHeader[ 0]. source), 

sizeofC serverAddress)); 
CheckGeomeiry( geomPackel); 
/* Record the starting and ending cylinders. */ 
StanCylinder = geomPacket->firstCyl; 
"EndCylindcr = geomPacket->!a$tCyl; 
/* Send back an "RSVP" packet. */ 
ccodc = sendRSVPPacketQ; 
if ( ccode) ( 

inform( stderr, "\nErTor sending RSVP packet: ccode Ox%x\n", ccode & Oxff); 
exit(l); 

) 

break; 

case CONFTRM.DOWNLOAD: 

. /* Hey, the server knows about us. We're in! */ 
return 0; 

default: 

if ( ImageGeomeiryFound) { 

/* Assume our CONFIRM.DOWNLOAD packet got lost, and the 

* server has started sending data already, so go ahead 

* and enter the RECEIVING phase. 
*/ 

return 0; 

) 

DBJNFORNK "Unexpected pkt cmd %d while trying to register for adownloadAn", 

geoniPacket->conimand); 

break; /* IGNORE it. */ 
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1 

) 

} 

/* Return Oxffffffff if no zeroes are found. */ 
sialic consi BYTE oneBiis[ 8] = { 

OxOJ « 0, 

0x01 « 1. 

0x0] « 2, 

0x01 « 3, 

0x01 « 4, 

0x01 « 5, 

0x01 « 6, 

0x01 « 7 

);• 

unsigned long 

findZero( BYTE *cylHead]yiap, unsigned long numBiis) 
{ 

unsigned int index; 

unsigned int numByies = 1 + (int)( numBits / 8); 
for ( index = 0 ; index < numBytes ; index ++) ( 
if ( cylHeadMapf index] != OxfQ { 
unsigned int bit; 
for ( bit = 0 ; bit< 8 ; bit++) { 

unsigned long biiNumber = ( ( (unsigned long)index 
* (unsigned long)8L) 
+ (unsigned long)bil}; 
if ( bitNumber >= numBits) { 

return OxffffffffL;/* Zero-bit not found. */ 
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) 

if ( 1 ( cylHeadMapl index] & oneBilsf bil))) { 
/* Found il! */ 
return bitNunnber; 

) 

) 

) 

) 

/* Didn't find any zeroes. */ 
return OxffffffffL; 

) 

/* Return state of a bil in the bitmap. */ 
int 

bitVaJue( BYTE *bilMap, unsigned long bit) 
I . 

ASSERT( (bit / 8L) < 65536L); 

return ( ( bitMap[ (unsigned int)( bit / 8)] 

& oneBilsl (unsigned ini)( bil % 8)]) 

? J 
:0); 

) 

/* Set a bit in a bitmap. */ 
void 

setBit( BYTE *bilMap. unsigned long bit) 
{ 

ASSERT( (bit / 8L) < 65536L): 

bitMap[ (unsigned int)( bit / 8)] 1= oneBilsl (unsigned ini)(bil % 8)]; 
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/* Send packet lo server re>requesling a missed track. 



* Returns the BYTE completioncode of the IPX send. 

* (Also returns Oxff if no "missing" track can be found.) 
* 

*/ 

BYTE 

sendMjssingTrackRequest( long cyl, 
long head) 



{ 



ECB sendECB; 
IPXHeader header; 
ResendPacket resend; 
int iransporlTime; 
/* Fill in the Resend packet data 
*/ 

. /* Immediate Address. */ 

if ( IPXGetLocalTargeK (BYTE far *)&serverAddress, 
sendECB.immediateAddress, 
&iransportTime)) { 
return Oxff; /* ERROR. */ 

) 

/* Packet data: missing cylinder and head. */ 

resend.command = RESEND.REQUEST; 

resend.cylinder = cyl; 

resend.head = head; 

/* Fill in the IPX packet header */ 
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memmove( &header.desiination, 
&servcr Address, 
si2eof( serverAddress)); 
header.packetType = 4 ; 
5 /* Fill in ihe ECB. */ 

sendECB .ESRAddress = NULL; 
sendECB.socketNumber = LocalSockel; 
sendECB.fragmentCount = 2; 
sendECB.fragmcntDescriptor(0].address = &header; 
^ 0 sendECB.fragmentDescriptor[0].size = sizeof( header); 

sendECB.fragmentDescriptor[ 1 ]. address = &resend; 
sendECB.fragmenlDescriptor[l ).size = sizeof( resend); 
/* Send the packet. */ 
IPXSendPacket( &scndECB); 
1 5 while ( sendECB.inUseFlag) { 

IPXRelinquishControIO; 

) 

DB^INFORM( "Sent request for missed track (%ld, %Id)\n", 

cyl, head); 

20 return sendECB.compJeiionCode; 

) 

/* Send packei(s) to server re-requesting missed tracks. 
* 

25 * Returns the BYTE compleiioncode of the IPX send. 

* (Also returns Oxff if no "missing" track can be found.) 

* 

BYTE 
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sendRequestForMissingTracks( BYTE *cylHeadMap) 
{ 

unsigned long track; 
unsigned long numTracks; 
5 unsigned long missingCyl; 

unsigned long missingHead; 
BYTEccode; 

/* Loop through all tracks looking for missing ones. 
10 * Send a resend request for the first missing one. 

*/ 

numTracks = ( 1 L + EndCyiinder - SiarlCylinder) * LocalNumHeads; 
for ( u-ack = OL ; track < numTracks ; track++) ( 
if ( I bitValue( cylHeadMap, track)) { 
' 5 missingCyl = SiartCylinder + ( track / LocalNumHeads); 

missingHead = track % LocalNumHeads; 

ccode = sendMissingTrackRequest( missingCyl, missingHead); 

if { ccode) { 

DB JNFORM( "srfm_iracks: error sending request for (%ld. %Id).\n". 

20 missingCyl missingHead); 

return ccode; 

) 

DB JNFORM( "srfm_lracks:Senl request for (%ld, %ld).\n", missingCyl, 

missingHead); 
25 break; /*Done!*/ 

) . . 

I 

return 0; 

} 
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/* Perform download from server. We process STD_DATA. FLUSH, and EXIT 

* packets from ihc server. 
* 

* We return ZERO when wc have downloaded the entire image from the 

* server. 

* We return nonZero if we failed to download the entire image from 

* the server. 
* 

*/ 

void 

processDataPackei( TrackBuffcr *tracklnfo» 
BYTIE *cyJHeadMap. 
BufferPacketHeader *pOurHeader, 
*BYTE*data) 

I 

inl i; 

#if defined( CHECK_FOR„OUT_OF_RANGE„CHS) 

if ( pOurHeader->cylinder >= Local NumCylinders 

II pOurHeader->head >= LocalNuniHeads 
H pOurHeader->secior > LocalNumScclors) ( 

DBJNFORM( "PDP: Illegal CHS (%1d.%1d.%1d) LNCHS=(%u,%u,%u), 

SC=%lu. EC=%!u\n", 

pOurHcader->cylinder, pOurHeader->head, pOurHcader->secior, 

Local NumCylinders, 

LocalNumHeads, 

LocalNumSeciors, 

SiarlCylinder, 
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EndCylinder); 
(void)gelch(); 

) 

#endif 

5 - /*********************************************^ 

/* If we aiready have this track, we don't need to process it. */ 
if(bitValue(cylHeadMap. ( ( ( pOurHcader-.>cylinder - SlartCylinder) 
* LocalNumHeads) 
+ pOurHeadcr->head))) { 
1 0 #if deflnedC BEAUCOUP„ VERBOSE) 

/* This is VERY verbose-ii prints on EVERY packei. 
*/ 

DB JNFORM( "SKIPPING UNNEEDED (%ld,%Id,%ld) LNCHS=(%u,%u,%u), 

SC=%lu\n". 

^ 5 pOurHeader->cylinder, pOurHeader->head, pOurHeader->sector, 

LocalNumCylinders, 
LocalNumHeads, 
LocalNumSectors, 
StartCylinder); 



20 #endif 



return; 



/* See if we have a trackbuf lo which we can add 
25 * this packet data. 

*/ 

for { i = 0 ; i < NUM.TRACKBUFS ; i++) { 

if ( CHEqual( pOurHeader->cylindcr, pOurHeader->head. 

tracklnfof i].cylinder. tracklnfo[ ij.head)) { 
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break; /* Found the right track. T contains its slot number. */ 

1 . 

} 

if { i >= NUM_TRACKBUFS) { 
5 /* NONE of ihe existing track buffers is assigned to the 

* cyl/head specified in the packet. Any existing 

* partial track buffers are therefore "panial", so 

* we request a resend of these tracks. 
* 

10 * Then we find a sloi where we can start storing the 

* "curreni" track data. If all ihe track buffers are full. 

* we clobber the lowest-numbered track and use that slot. 
*/ * 

for ( i = 0 ; i < NUM_TRACKBUFS ; i++) { 
15 if ( iracklnfo[ il.cylinder != -1) | 

/* Send request for lost track. */ 
if ( sendMissingTrackRequest{ trackInfo[ i].cylinder, 
lrackInfo[ ij.head)) { 
DB JNFORM( "sendMissingTrackRcquest failure.\n"); 

20 ) 

) 

) 

/* Now search for an empty sloi into which we can start this new . 

* track. 
25 */ 

for ( i = 0 ; i < NUM^TR^ACKBUFS ;. i++) | 
if( tracklnfol i].cylinder==:-l) ( 
break; /* Found il. */ 

) 
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) 

if ( i >= NrUM_TRACKBUFS) { 

/* All track buffers fuJl. Zap ihe lowesi-numbcred 

* buffer for use NOW- we'll re-requesi the missing track 

* so thai the server will send it to us again later. 
*/ 

long lowest_cyl = Ox7fffffffL; 
long Iowest_head = Ox7fffffffL; 
int lowesi^index = - 1 ; 

for ( i = 0 ; i < NUM_TRACKBUFS ; i++) { 

if ( CHIessThan( trackJnfo[ i].cylinder, irackJnfo[ ij.head, 
lowesi_cyl, iowest_head)) { 
lowesl__cyl = iracklnfof ij.cylinder; 
lowest^head = trackInfo[ i].head; 
lowest Jndex = i; 

) 

) 

ASSERT( lowesijndex !=-!); 

i = lowesi^indcx; /* Setup T to point to the "lost" track slot. */ 



/* 'i* points to a slot where we can start a new track. */ 
tracklnfol i]xyiinder = pOijrHeader->cylinder; 
lrackJnfo[ i].head = pOurHeader->head; 

memsei( irackinfof i).sectorMap, SLOT.EMPTY. LocalNumSectors); 
2^ DB JNFORM( "Started new track in slot %u for C=%lu, H=%Iu.\n". 

i, tracklnfof ij.cylinder, irackInfo[ i].head); 
/♦ Fall-through to store the data in the track buffer. */ 

) 

/* i points to the iracklnfo buffer for this packet. */ 
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if ( lrackInfo[ i].sectorMap[ (unsigned int)(pOurHeader->sector - 1)] 
!= SLOT, VALID_D ATA) { 
memmove( &lrackJnfo[ i],seciorDaia| 512 * (unsigned intXpOurHeader.>sector - 1)], 
daia, 

5 ^ 512); 

trackJnfo[ i].sectorMap[ (unsigned inl)(pOurHeader->sccior - 1)] = 
SLOT.VALIDJDATA; 
) 

mr defmed( BEAUCOUP_ VERBOSE) 
10 if(DebugBroadcast) { 

static char lineBufl 250j; 
im q; 
inl x,y; 

for ( q = 0 ; q < LocalNumSectors ; q++) { 
'5 if ( irackJnfo[ i].seciorMap[ q] == SLOT_EMPTY) ( 

lineBuf[ q] = 

) 

else { 

lincBufl q) = 

20 ' , 

) 

lineBufl q] = '\0'; 
x=wherex(); 
y=wherey(); 
25 goioxy( i,20); 

cprinlf( X %ld, h %ld:%s". 
iracklnfol i].cylinder, 
trackJnfof ij.head, 
lineBuO; 
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clreoIO; 
goioxy( X, y); 
• ) ■ 

#endif 

/* Wriie a track to disk. */ 
void 

wriieTrackC TrackBuffer *irack) 
10 { 

int ccode, 

retryCouni; 

reiryCount = 0; 
do{ 

1 5 // Try to write the head 

ccode = biosdisk(WRrrE, 

HD^DRIVE, 

(int)track->head, 

(!nt)irack->cylinder, 

* • . //since we read an entire head, secior=I 

LocalNumSectors, 

lrack->seciorDaia); 

if ( ccode) { 

Disp]ayBiosError( ccode, 20, 25); 
25 retryCount++; 

) ... . • 

) while ( ccode && reiryCounl < 5); 
if (ccode) { 

//are we clean yet? No erros. 
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if(ccode!=Oxll)( 

' * //we can 

recover from CRC errors 

spri nlf(ErrorMessage, 

"\n\nBios error %d writing at cylinder %d, head %d'\ 
ccode, 

track->cylinder, 

track->head); 
LogErrorCBIOSERR, ErrorMessagc); 
CleanExitO; 



/* Write was successful. Now read the track 
* back and compare to the original. 
15 */ 
#ifO 

if(0){ 

rctryCount = 0; 
do{ 

2^ // Try to write the head 

ccode = biosdisk(READ, 

HD_DRIVE, 

(int)irack->head, 

{inl)U'ack->cylinder, 
25 1, • * 

//since we read an entire head, sector=I 
LocalNumSeciors, 
CpmpareHeadBuffer); 

if ( ccode) { 
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DisplayBiosErTor( ccode, 20, 25); 



relryCouni++; 



) while ( ccode && retryCouni < 5); 



5 



if (ccode) { 



//are we clean yet? No erros. 



if (ccode != 0x11)1 



//we can recover from CRC errors 



sprinlf(ErrorMessage» 

"\n\nBios error %d reading at cylinder %d, head %d". 
ccode, 

track->CYlinder, 
track->head); 

LogError(B10SERR, ErrorMessage); 
CleanExilO; 



) 

/* Got the data OK. Now compare. */ 

if ( Tneincnip( track->sectorDaia, CompareHeadBuffer, LocalNumSectors * 512)) { 
sprinlf(ErrorMessage, 

"\n\nData mismatch error at cylinder %d, head %d", 



irack->cylindcr. 



irack->head); 



LogErrorfBlOSERR, ErrorMessage); 



25 



CleanExitO; 



#endif 
) 



wo 98/50874 



PCT/US98/09018 



186 

/* Update the cylinder/head map (set the bit for the good track), 
* then update the "goodUpTo" value. 
*/ 

5 void 

niarkTrackComplete( BYTE *cylHeadMap, 
long cylinder, 
long head) 

{ 

1 0 unsigned long cy IHead; 

cylHead = ( ( cylinder - StariCylinder) * LocalNumHeads 

+ head); 
selBiK cylHeadMap. cylHead); 

I 

void 

nushCompleteTracks( BYTE *cylHeadMap. 

TrackBuffer *lracklnfo) 

. { . . 
20 inti; . 

inl sector; 

for ( i = 0 ; i < NUM_TRACKBUFS ; i++) { 
^ if ( trackJnfo[ i].cylinder =:= - 1 ) | 

continue; /* Empty slot. */ 

25 ' ) ■ 

for ( sector = 0 ; sector < LocalNumSectors ; secior++) { 

• if ( iracklnfol i].sectorMap[ sector] != SLOT^VALID^DATA) { 
break; 
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) 

if ( sector >= LocalNumSectors) { 
/* COMPLETE HEAD */ 
■ /* Flush it to disk. */ 
writeTrack( &tracklnfo[ i]); 
markTrackCompIetc( cylHeadMap, 
trackInfo[ ij.cylinder, 
iracklnfof i].head); 

/* Mark track buffer good for reuse. */ 
iracklnfof i]. cylinder = -1 ; 
lracklnfo[ ij.head = -1; 

memset( iracklnfof iJ.sectorMap, SLOT^EMPTY, LocalNumSectors); 



5 ) 
void 

processSkjpTrackPacket( BYTE *cylHeadMap, 

TrackBuffer *trackInfo. 
0 SkipTrackPacket *sip) 

( 

int i; 

/* Find any track buffers with the skipped cyl/head and 
5 * zap the buffers. 

* (This should never happen, really, but we're being paranoid.) 
*/ 

for ( i = 0 : i < NUM.TRACKBUFS : i++) { 

if ( CHEquaK sip->cylinder, sip->head, 



wo 98/50874 



PCT/US98/09018 



188 

trackInfo[ jj.cylinder, trackInfo[ ij.head)) { 
trackInfo[ ij.cylinder = -1 ; 
tracklnfo[ ij.head = -]; 

HiemseK tracklnfof i].seclorMap, SLOT_EMPTY. LocaiNumSeciors): 



/* Now mark the track complete in the bitmap and adjust our "goodUpTo" 
* values if needed. 
10 */ 

markTrackComplete( cylHeadMap, sip->c>'iinder, sip->head); 
DBJNFORM( "SKIP (%ld,%Id)", sip->cylinder, stp->head); 

) 

15 /* Return ONE if we should quit, or ZERO if we should continue. */ 
im 

processPacket( BYTE *cyIHeadMap, 

TrackBuffer *trackInfo, 
ECB far *ecb) 

20 { 

IPXHcader *pHdr = ecb->fragmeniDescriptor[ 0). address; 
BufferPackelHeader *pOurHeader = ecb->fragmeniDcscriplor[ Ij.address; 
BYTE *daia = ((BYTE *)pOurHeader) + sizeof( *pOurHeader); 

25 /* Validate thai packet came from server from which" 

* we received geometry info. 
*/ 

if ( memcmpC AserverAddrcss, &( pHdr->source), sizeof( server Address))) { 
DB JNFORM( "Dropping packet from other Master."); 
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return 0; 

) 

/* Display Master's MAC address on the first received packet. */ 
5 if (MasterMACFound == FALSE) { 

DispIayMasterMAQ ecb); 
MasterMACFound = TRUE; 

} 

10 When first packet received, display a message signifying 

* our'transition from "ready" to "receiving" state,. 
*/ 

if ( programSiate == STATE. READY 

&& pOurHeader->cominand != GEOMETRY) { 
1 5 progrannStaie = STATE_RECEI VING; 

TopLargeMsgC 0, " RECEIVING 

) 

swiich( pOurHeader->conimand) { 
20 case STD.DATA: 

processDataPackei( irackJnfo, 

cylHeadMap, 

pOurHeader, 

data); 

25 break; 

case FLUSH: 

processDaiaPackei( iracklnfo, 

cylHeadMap. 

pOurHeader, 
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data); 

nushComp!eieTracks( cylHeadMap, 
irackJnfo); 

DisplayProcData( pOurHeader->cyIinder. pOurHeader->head. pOurHeader->seclor 

break; 

case SKJP^TRACK: ( 

SkipTrackPackei *stp = (SkipTrackPacket *)ecb->fragmenlDescriptor[ l).address; 

processSkipTrackPackeK cylHeadMap. 

iracklnfo, 

Stp); 

DisplayProcDataC stp->cylinder, sip->head, 0); 
break; 

) 

case EXIT; 

/* Server is done sending data. WeVe done only if we 
* have NO missing fragmenis. 
*/ 

if ( programSlalc != STATE_nNISHING) { 

programSiaie = STATE.FINISHING: 
TopLargeMsg( 0. " RNISHING "); 

) 

#if 0 /* BIG BAD MISSED SECTOR DEBUG */ 
if ( programState == STATE.RNISHING) { 

int x=wherexO. y=wherey{); 

inli; 

goioxy{ 1,9); 
cpfintfC'EXlT"); clreo!(); 
go!oxy( J, 10); 

cprintf( "TB: cyl %ld, head %!d\r\n". irackInfo->cylinder, lrackInfo->head); 
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for ( i = 0 ; i < LocalNumSeciors ; i++) { 

cprintf( "%c". ( trackJnfo->seciorMap[ i] == SLOT.EMPTY) ? '/ ; '#'); 

) 

gotoxy( X, y); 



#endif 

/* We can exit only if we have no missing tracks. */ 
if ( rindZero( cylHeadMap, ( ( I + EndCylinder - SiariCylinder) 
* LocalNuniHeads)) == OxffffffffL) { 

DBJNFORM{ •■processPackeK): No missing tracks, we're done.Vn"); 

return 1;/* DONE! */ 

) 

else ( 

/* We have niissing fragments. Send "missing track" packet(s). */ 
if ( sendRequeslForMissingTracks( cylHeadMap)) { 

DBJNFORM( "sendRequestForMissingTracks failureAn"); 

} 

DB JNFORM( -processPackeK): sent Request for missing iracksAn"); 

) 

break; 

default: 

/* Ignore other packet types. (We expect to see GEOMETRY packets 
* until the server starts really sending data. 
*/ 

DBJNFORM( "processPacketO: Dropped Packet type 0x%02xAn'\ Oxff & pOurHeadcr- 

>conimand); 

break; 

) 

return 0: /* Need to continue. */ 
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/* Return ZERO on success, nonZero on failure. 

*/ 
im 

receiveDaia( void) 
{ 

TrackBuffer lrackInfo[ NUM_TRACKBUFS]; 
BYTE *cyIHeadMap; 

unsigned long cylHeads = ( 1 + EndCylinder - SiartCylinder) * LocalNumHeads; 
unsigned int bytesInCylHeadMap = 1 + (unsigned ini)( cylHeads /8); 
int i; 
im done; 

/* Allocate cylinder/head map. */ 

cylHeadMap = (BYTE *)manoc( byieslnCylHeadMap); 

if ( cylHeadMap=:= NULL) { 

infori7i( siderr, "\nError allocating track buffersAn"); 

return 1;/* ERROR */ 

) 

memsei( cylHeadMap, 0x00, byieslnCylHeadMap); 

/* Allocate track buffers. */ 

for ( i = 0 ; i < NUM_TRACKBUFS ; i++) { 

irackJnfof i].cy!inder = -1 ; 

irackInfo[ i].head = -1; 

irackJnfof ij.sectorMap = (BYTE *)ma!loc( LocalNumSeciors); 
if( irackJnfol il.sectorMap == NULL) | 
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break; 

) 

/* Initialize sector map. */ 

memseK iracldnfo[ i].seciorMap, SLOT.EMPTY, LocalNumSectors); 
5 trackJnfo[ i].sectorDaia = (BYTE *)malloc( LocalNumSectors * 5 1 2); 

if ( lrackInfo[ iJ.sectorDaia == NULL) { 
free( trackInfo[ iJ.seciorMap); 
break; 

1 

10 } 

/* If error during allocation, free currently-allocated 
* buffers and return error. 
*/ 

^ 5 if ( i < NUM_TRACKBUFS) | 

/* ERROR allocating buffers. */ 
for(~i;i>=0;i--) { 

frec( tracklnfo[ iJ.seciorDaia); 

free( trackJnfo( iJ.seciorMap); 

20 } 

inform( stderr. "\nError allocating track buffers.\n"); 
return I;/* ERROR */ 

) 

25 /* Initialize "completed ECBs" list. */ 

initEsrQueueO; 

/* Initialize and Post a bunch of receive ECBs */ 
for (i=0; i<NUMBER„ECBs; i++) { 

receiveECBIiJ.ESRAddress = ESRHandler; 
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receiveECB[i].socketNumber = LocalSockci; 
receiveECB[i].fragmentCount = 2; 

receiveECB[i].fragmentDescriptorIO].address = &receiveHeader[j]; 
receiveECB[i].fragmentDescriptor[0].size = si2eof(IPXHeader); 
5 receiveECB[i).fragmenlDescnptor[l].address = IPXDataBuffer[i]; 

receivcECB[i).fragmentDescriptor[l].si2e = 512 + sizeof(*pOurHeader); 
IPXListenForPackeiC &receiveECBl i]); 

) 

/* Now loop until we've received the entire download. */ 
10 done = 0; 

do i 

ECB far *ecb; 

IPXRelinquishControIO; 

if(kbhit()){ 

^5 int choice = getchO; 

'if ( choice == 0) { 

/* two-character keystroke. */ 
(void)getch(); /* Throw away second byte - don't match 2-char keys. */ 
* ) 

else if ( choice == 1 ) { /* Match control-A keystroke? */ 

break; /* Break out of loop on '^A (conirol-a) characters. */ 

) 

#if definedC KEY_ENABLE^ DEBUG) 

else if ( choice == '@') ( 
•5 if ( DebugBroadcasi != TRUE) { 

DebugBroadcast = TRUE; 

DB JNFORM( "DebugBroadcasi Enabled.\n"); 

) 

else { 
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DBJNFORIVK "DebugBroadcast Disabled.\n"); 
DebugBroadcast = FALSE; 

) 

) 

#endif 

) 

/* Loop to remove packels from the "completed" list. 

* Process each packet in turn, and then repost the 

* ecb to the listen queue. 

*/ 

ecb = receivedPackctO; 
if (ecb) { 

if (ecb->completionCode !=0) { 

DB_INFORM( "Receive packet error: ccode Ox%x\n", ecb->completionCode); 
) 

else { 

/* Process the packet. */ 

if ( processPacket{ cyiHeadMap, iracklnfo, ecb)) { 
/* We re done. */ 
done = 1 ; 

) 

) 

IPXLisienForPacket( ecb);/* Repost the listen. */ 

) 

) while ( I done); 
if ( done) ( 

TopLargeMsg( 0, " COMPLETE "); 
) , ■ 

/* CANCEL any pending listens. */ 
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for (i=0; i<NUMBER_ECBs; 1++) { 

if ( receiveECB[ iJ.inUseFlag) { 

if ( IPXCancelEvent( &receiveECB[ i])) { 

inform( stderr, "VnFailed to cancel IPX lisien.\n"); 



) 

/* Free allocated storage. */ ' 
for ( i = 0 ; i < NTJM_TRACKBUFS ; i++) { 
JO free( trackJnfo[ iJ.sectorDaia); 

free( iracldnfo[ ij.sectorMap); 

} 

free( cylHeadMap); 
return ! done; 

15 ) 

/* Wail for "goodbye" packet, send back "fare thee well" packet, 
** then wail for "fare thee well ACK" packet. 

20 * Return ZERO if we get the ACK. Return nonZero if we receive an 
* unknown packet. 
*/ 
im 

sayGoodbyeToServer( void) 
25 { • 

ECBFragmenl rxFrags[ 2] = { 

i &rcceiveHeader[ 0], sizeof{ receiveHeaderf 0]) ). 
{ IPXDataBufferl 0], sjzeof( IPXDaiaBuffer[ 0]) ) 

); 
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BYTEccode; 
while ( 1) { 

/* Wait for a packet. */ 

if ( waitForPackeK J . /* Terminate on (conlrol-a) keypresses. */ 
0, /* Don't timeout based on the clock. */ 
LocalSockel, 
2, 

rxFrags. 
&ccode) != 0) ( 

/* No packet received: key was pressed instead. */ 

inform( stderr, "\nGoodbye-packei wail cancelled by keypress.\n"); 

exit( 1); 

) 

/* Got a packet. Check the completion code. */ 
if ( ccode) { 

inform( stderr, "\nPacket reception error: ccode Ox%x\n", (Oxff & ccode)); 
exit( 1); 

) 

/* Packet received OK. Get the header. */ 
pOurHeader = (BufferPacketHeader *)lPXDataBuffer[ 0]; 
switch( pOurHeader->command) { 
case GOODBYE: 

/* Send back a "fare ihee well" packet. */ 
ccode = sendFarewellPacketQ; 
if ( ccode) { 

informC stderr, "\nError sending farewell packet: ccode bx%x\n", ccode & Oxff); 
exit( 1); 

1 

break; 
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case FAREWELL. ACK: 

/* Hey, the server knows we re gone. */ 
return 0; 

default: 

break: /* Ignore all other packet lypes. */ 

) 

) 

) 

Stan of program 

int 

mainOnt argc, char * argvl]) 
{ 

// check usage paranneters, display USAGE if needed. 
if(argc> 1) { 

if(sirsir(argv[l), != NULL) { 

DisplayUsageO; 

ClcanExilO; 

) 

else if ( stricmpC "-db", argv( 1 )) == 0) { 
DebugBroadcasi = TRUE; 

) 

else if ( stricmp( "-1", argv( I]) == 0) [ 
displayMyLicensesO; 
CleanExilO; 

) 

) 

if ( liccnseCouni( NULL, ProgramlD. ProgramMajorVersion) == 0) { 
printfC'This program is not iicensedAn"); 
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exit( 1); 



if ( isEvalLicense( ProgramID, ProgramMajorVersion)) { 

evaluation^noiiceO; /* from common/clicntyeval/eval.c */ 
5 evalProgram = 1 ; 

1 

// Iniiializc the needed info for the program 
InitializeO; 

/* Wail for geomeiry packet, send back "rsvp" packet, 
10 * then wail for "rsvp ACK" packet. 

*/ 

programSiaie = STATE_FIND_MASTER; 
TopLargeMsg( 0, "HND MASTER"); 
if ( regisierWithServerO) { 
15 inform( siderr, 

"\nUnable to register for downJoadAn"); 

exit( 1); 

) 

programStaie = STATE_READY; 
20 TopLargeMsgC 0. " READY "); • 

if ( receiveDataO) ( 

inform[ siderr, 

AnError downloading data from server.\n"); 

exit( 1); 

25 ) 

programStaie = STATE_DISCONNECT; 
TopLargeMsg( 0, "DISCONNECT"); 
if ( sayGoodbyeToServerO) { 
inforni( siderr. 
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"\nServer left before we could say goodbye.\n" 
"But the download is siiJl COMPLETE.Xn"); 

exit( 0); 

) 

5 TopLargeMsg( 0, " DONE *'); 

inform( stderr, 

"\nDjsconnecied from servcr.\n"); 
return 0; /* SUCCESS! */ 

) 

10 /*************************************************#******* 
Program: Initialize 

Descripiion: This function initializes the data for the program. It 
does the following: 

1 - Initializes IPX 
^5 2 - Opens the IPX socket 

3 - Gets the local drive geometry 
Author: Kevin J. Turpin Dale: 6 May 1996 

void InilializeO 
20 { 

// Initialize IPX 
IPXlnilializeO; 
/* Open Socket */ 
if (lPXOpenSocket((BYTE *)&Local Socket, 0) != 0) ( 
25 • sprintf(ErrorMessage, "\n\nErTor opening socket!"); ' 

LogErrordPXOPENSOCKETERR, ErrorMessage); 
CieanExitO; 
) . • 

sockelOpen = 1 ; 
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/* Verify that we opened ihe desired socket. */ 

if ( LocalSocket != SWAP_WORD( D0WNLOAD_S0CKJET_NUMBER)) { 
sprimf(ErrorMessage, "\n\nUnabIe to bind socket Ox%x!", 
DOWNLOAD_SOCKET_NUMBER); 
5 LogErrordPXOPENSOCKETERR. ErrorMessage); 

CleanExiiO; 

) 

// Display the static screen text 
DisplaySiaticScreenDaiaO; 
10 //If this is an evaluation copy, write eval message 

WriteEvalMessageO; 

// Get the MAC address of this machine and display it 
IPXGetJnternetworkAddress(Nel Address); ■ 
DispIayLocalMAC( Net Address); 
1 5 // Get local drive geometry 

GetDriveGeomelryO; 
DisplayLx)caiGeometry(); 
// Allocate memory for compare buffer 

if ((ComparcHcadBuffer = (unsigned char *) calloc((512*LocaINumSectors). 
20 sizeof(char))) == NULL) ( 

sprintf (ErrorMessage, "Noi enough memory to allocate Compare Head bufferl\n"); 

LogErrorCALLOCERR, ErrorMessage); 

CleanExitO; 

) 

25 ) 

/*»**«*♦*»*********♦*******************************#***♦**#*****#>►** 
Program: GeiDriveGeomelry 

Description: This function determines the local drive geometry by 
reading the data from the drive partition table. 
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Author: Kevin J. Turpin Date: 6 May 1996 

void GetDriveGeomeiryO 
I 

5 im ccode; 

unsigned char impBuffer[512]; 

ccode=biosdisk(8. HD.DRIVE, 0, 1, 1.1, tmpBuffer); 

if (ccode) { 

sprinif(ErrorMessage, "\n\nBios error %x reading drive geometry.", ccode); 
10 LogError(BIOSERR, ErrorMessage); 

CleanExitO; 

) . 

LocalMaxCylinders = tmpBuffer[l] + ((lmpBuffer[0]»6) « 8); 
LocalMaxSectors = tnipBuffer[0] & Ox3f; 
15 LocalMaxHeads = tmpBuffer[3); 

LocalNumCylinders = 1 + LocalMaxCylinders; 
LocalNumHeads = 1 + LocalMaxHeads; 

LocalNumSeciors = LocalMax Sectors; /* sectors already count f'ronn 1 ..max, 

* so we don't need to add one to the 
20 . * maxSecior number to get "numSeciors". 

*/ 

} 

Program: CheckGeometry 
25 Description: This function is called by direction of a received IPX 

packet command. It takes the geometry received in the 
IPX packet and compares it with the local drive geometry. 
If lliey are not the compatible, an error message is displayed 
and the program is' terminated. 



wo 98/50874 PCTAJS98/09018 

203 

If they are ihe same, the function returns normally. 
Author: Kevin J. Turpin Date: 6 May J 996 

void CheckGeometry( GeomeiryPacket *pGeom) 
I 

/* We don't care if the geometry of the source machine (geomCylinders) 

* is greater than our geometry, so long as the image 

* itself doesn't overrun our disk. Hence the checks 

* of flrsiCyl and tastCy) (which specify the image 

* range on the disk), and the LACK of checks 

* against geomCylinders (which we don't care aboul if 

* the image itself is in range), 

* Note that we DO care about matching heads and sectors! 
• */ * 

if ( ( pGeom->firstCyl > LocalMaxCylinders) 

II ( pGcom->laslCy] > LocalMaxCylinders) 

II ( pGeom->geomHeads != LocalMaxHeads) 

II ( pGeom->geomSectors != LocalMaxSectors)) { 
sprintf(ErrorMessage, "Wrong Geometry"); 
LogError(BADGEOMETRY.ErrorMessage); 
BeepO; 
BeepO; 
BecpO; 

printf{"\n\nlmage geometry does not match local geomeiryf"); 
prinif{*'\n\nCannoi receive the image."); 
prinlf("\n\nlmage First Cylinder %Iu. Last Cylinder %lu", 
pGeom->firsiCyl, pGcom->lastCyl); 



wo 98/50874 



PCTAJS98/09018 



printf("\n\nLocal geometry = Cylinder - %d", Local MaxCyiinders); 
printf("\n Head - %d". LocalMaxHeads); 

printfC'\n Sectors - %d", LocalMaxSeciors); 

printf("\n\nlmage geometry = Cylinder - %&\ pGeom->geomCylindcrs); 
5 printf("\n Head - %d", pGeom->geomHeads); 

printf("\n Sectors - %d\n\n**, pGeom->geomSectors); 

CleanExitO; 

) 

. // If first time to check geometry, display image geometry 
10 if (ImageGeometry Found == FALSE) { 

ImageGeomelryFound = TRUE; 
DisplaylmageGeometry( pGeom); 

) 

) 

15 /**********************************************************#******* 
Program: Beep 

Description: This function makes the speaker beep. 
Author: Kevin J. Turpin Date: 6 May 3996 

20 voidBeepO 
( 

sound(600); 
delay(400); 
nosoundO; 

25 ) 

Program: DisplayUsage 

Description: This function displays the usage for this program. 
Author: Kevin J. Turpin Date: 6 May 1996 
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void DisplayUsageO 
( 

clrscrQ; 

5 printfC'Vnlniage Slave version %u.%u.%u". 

ProgramMajorVersion, 
ProgramMinorVersion, 
ProgramRe vision); 
primffXnCopyright 1996-1997. KeyLabs,Inc. All rights reserved."); 
10 primf('*\n" 

"\n" 

"KeyLabs, Inc.\n" 
"633 South 550 Easl\n" 
"Provo. Uiah 84606\n" 
15 "Phone: 801-377-5484\n" 

"\n"); 

/* Print disiribmor info. */ 
decrypi_printstring( disiribuiedBy); 
prinlf("\n\n" 

20 . "USAGE:"); 

prinlf("\n" 

" LMGSLAVEI -L]"); 

printf("\n\n"); 

prinlfC -L Display License information."); 
25 . prinlfOnVn"); 

) • 

Program: DispIayBiosError 

Descripiion: This function displays the error message associated with 
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the BIOS error (as specified in the BC library book). 
Author: Kevin J. Turpin Dale; 6 May 1996 

void Displays iosError(ini ccode, inl x, int y) 
5 { 

goioxy(x, y); 
swiich(ccode) { 
case 0x00: 

cprintf( "Error %x - Operation successful.", ccode); 
10 break; 

case 0x01: 

cprintf( "Error %x - Bad command.", ccode); 
break; 
case 0x02: 

15 cprinif( "Error %x - Address mark not found.", ccode); 

break; 
case 0x03: 

cprintfC "Error %x - Attempt to write to \vrite-proiected disk.", ccode); 
break; 

20 case 0x04: 

cprintfC'Error %x - Sector not found.", ccode); 
break; 
case 0x05: 

cprintf( "Error %\ - Reset failed.", ccode); 
25 break; 

case 0x06: 

cprinlf("Error %x - Disk changed since last operation.", ccode); 
break; 
case 0x07: 
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cprintf("EiTor %x - Drive parameter activity failed.", ccode); 
break; 
case 0x08: 

cprinlfC'Error %x - DMA overun.", ccode); 
5 break; 

case 0x09: 

cprinlfC'Error %x - Attempt to DMA across 64K boundary,", ccode); 
break; 
case OxOa: 

1 0 cprintf("Error %x - Bad sector detected.", ccode); 

break; 

case OxOb: 

cprintf( "Error %x - Bad track delected", ccode); 
break; 

1 5 case OxOc: 

cprintfCError %x - Unsupported track.", ccode); 
break; 
case 0x10: 

cprintf("Error %x - Bad CRC/ECC on disk read.", ccode); 
20 break; 

case 0x11: 

cprintfCError %x - CRC/ECC corrected data error.", ccode); 
break; 
case 0x20: 

25 cprintf("Error %x - Controller has failed.", ccode); 

break; 
case 0x40: 

cpnmf("Error %x - Seek operation failed.", ccode); 
break; 
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case 0x80: 

cprinllC'Error %x - Attachment failed lo respond.", ccode); 
break; 
case OxAA; 

5 . • cprimfC'EiTor%x- Drive not ready.", ccode); 

break; 
case OxBB: 

cprintf("Error %x - Undefined error occunred.", ccode); 
break; 

10 • caseOxCC: 

cprintf( "Error %x - Write fault occurred.", ccode); 
break; 
case OxEO; 

cprinifC Error %x - Status error.", ccode); 
15 break; 

case OxFF: 

cprinlfC'Error %x - Sense operation failed.", ccode 
); 

break; 

20 default: 

break; 

) 

• } 

25 'Program; LogError 

Description: Tliis function displays error messages passed to it from 
the calling function. It displays in large text either 
"SUCCESS" or "ERROR" depending on the error code. 
Author: Kevin J. Turpin Date: 7 May 1996 
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*********************************************************** 
void LogError(ini errCode, char * errMessage) 

{ • 
if(errCode==0) { 
5 Display LargeMsgC I, "Success"); 

printf("\n%s -> Code = %d\n'\ errMessage, errCodc); 

) 

else { 

DisplayLargeMsg(l/' Error"); 
1 0 prinif("\n%s -> Code = %d\n'\ errMessage, errCode); 

// exit(O); 
) 

} 

/********************************** **3|:#****:(e*******************************:(c* 

15 Program: DispiaySiaticScreenDala 

Description: This function displays ihe static portion of the screen 
text. 

Author: Kevin J. Turpin Date: 7 May i996 

********************#******************************************;!,#* J(,:,.*J(;^^5^^^^^^ 

. 20 void DispiayStaiicScreenDataO 
{ 

inl i; 

// Display the static portions of the screen 

clrscrO: ' 
25 texicolor(UGHTGRAy); - 

for (i=0; i< NUM_STATIC^SCREEN^DATA; i++) { 
goloxy(SlaticScreenDaia[i].x, 

SlalicScreenPata[i].y); 
cpnnlf("%s", StaticScreenDaia[i].Texl); 
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// Now we will change the lexl color lo BOLD WHITE for all dynamic data 
lexlcolor{WHITE); 

■} * • ■ • . 

5 /*********************************************************** 
Program: CleanExit 

Description: This function puts the computer back into the proper state 
before exiling. This includes: 

- Changing text color back to normal 
10 - Freeing any allocated memory 

- exiting 

Author: Kevin J. Turpin Date: 7 May 1996 

void GeanExitO 
15 { 

int i; 

// Change text back to normal 
lextcolor(UGHTGRAY); 
// Free any allocated memory 
20 . if (CompareHcadBuffer != NULL) 

f ree(CompareHeadB u f fer) ; 
// Is our image good? If not, display error message 
if(IHCount>0) I 

sprintf(ErrorMessage, "Some data was lost during image- process! Drive may be corrupted !\n"); 
25 . LogErrordNCOMPLETE, ErrorMessage); 

) 

/* CANCEL any pending listens. */ 
for (i=0; i<NUMBER„ECBs; { 

if ( receiveECB[ i].inUseFlag) { 
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if ( IPXCancelEvenK &receiveECB[ i])) { 

inform( siderr, "\nFajled to cancel IPX iislen.\n"); 

) 

) 

5 ) 

/* Close IPX socket if it was open. */ 
if ( socketOpen) { 

IPXCIoseSockel( LocalSockei); 

} 

10 // Now lets exit 

exit(-l); 



Program: DisplayLocalGeometry 
15 Description: This function displays the local drive geometry. 

Author: Kevin J. Turpin Date: 7 May 1996 

void DisplayLocalGeonieiryO 

{ * ■ ■ * . 

20 goioxy(DynamicScreenData[LOCALCYL].x» 

DynamicScreenData[LOCALCYL].y); 
cprintf("*M4d", LocalMaxCylinders); 
gotoxy(DynamicScreenData[LOCALHEAD).x, 

DynaniicScreenDala[LOCALHEAD].y); 
25 cprintf("%#4d", LocalMaxHeads); 

goioxy(DynamicScreenData[LOC-\LSECT].x, 

DynamicScreenData[LOCALSECT].y); 
cprintf("%#4d". LocalMaxSectors); 

) 
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Program: DisplaylmageGeomeiry 

Description: This function displays the Image geometry as passed by 
the IMGBLASTER. 
5 Author: Kevin J. Turpin Dale: 7 May 1996 

void DispIaylmageGeometry( GeometryPacket *pGeom) 
{ 

goloxy(DynamicScreenData[MASTERCYL].x, 
1 0 DynamicScreenData[MASTERCYL].y); 
cprinifC " %#4d" . pGeom->geomCy!inders) ; 
goioxy(DynamicScreenDala(MASTERHEAD].x, 

DynamicScreenData[MASTERHEAD].y); 
cprinif('*%#4d", pGeom->geomHeads); 
1 5 gotoxy(DynamicScreenData[MASTERSECT].x, 

DynamicScreenData[MASTERSECT|.y); 
cprinlf("%#4d", pGeom->geomSectors); 

) 

/***********************************************************+* 
20 Program; DispIayProcData 

Descripiion: This function displays the processing data. This includes 

the current Cylinder, Head, and Sector. 
Author: Kevin J. Turpin Date: 7 May 1996 

25 void DispIayProcDaia( long cylinder, long head, Jong sector) 
I 

goioxy(DynamicScreenData(PROCCYL].x, 

DynamicScreenDaia[PROCCYL).y); 
cprinif{"%#4d", cylinder); 
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goioxy(DynamicScreenData[PROCHEAD].x, 

DynamicScreenData(PROCHEAD].y); 
cprinlf("%#3d'\ head); 
gotoxy(DynamicScreenDala[PROCSECT].x, 
5 DynamicScreenData[PROCSECT].y); 
cprintf("%#3d", sector); 
) ' • 

Program: DisplayMasicrMAC 
10 Description: This funciion displays the MAC address of the master 

controller (IMGBLASTER). This is called only once. 

A flag is set to prevent multiple calls. 
Author: Kevin J. Turpin Date: 7 May 1996 

1 5 void DisplayMasterMAC( ECB far *ecb) 
{ 

// Display the master's MAC address 
goioxy(DynamicScreenDala[MASTERMAC].x, 
DynamicScreenDatafMASTERMACJ.y); 
20 cprintf("%02x%02x%02x%02x%02x%02x". 

ecb->iinmediaieAddressIO], 
ecb->immediate AddressI I ], 
ecb->immediaieAddress[2), 
ecb->immediaieAddressf31, 
25 ccb->immediaie Address [4], 

ecb->inimedialeAddress[5]); 

) 

Program: DisplayLocalMAC 
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Description: This function displays the MAC address of the local 

computer (IMGSLAVE). 
Author: Kevin J, Turpin Date: 7 May 1996 
****************************************^^ 

5 void DisplayLocaIMAC( BYTE *netAddress) 
{ 

goioxy(DynamicScrecnData[LOCALMAC].x, 

DynaniicScreenData[LOCALMAC).y); 
cprinlf("%02x%02x%02x%02x%02x%02x", 
10 nelAddress[ 4], 

netAddresst 5), 
net Address! 6], 
net Address [ 7], 
neiAddress[ 8), 

15 net Address! 9]); 

) • ' • 

■ Function: WriteEvalMessage 
Description: This function displays an Evaluation Message to inform 
20 the user that this copy of the utility is an Eval only 

copy. This message is only displayed if the 
evalProgram flag is set. 
Author: Kevin Turpin Date: 30 Oct, 1996 
Modifications: 

void WriteEvalMessage( void) 
{ 

if ( evalProgram) | 

int xcord, ycord; 
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// Find out if we should display ihis message 
// Write Eval only copy 
xcord = wherexQ; 
ycord = whereyO; 
5 texlcoIor(WHITE); 

goioxy(45,23); 

cprintf("*** For Evaluation Purposes Only ***"); 
gotoxy(48.24); 

cprintfC*'*** Not For Production Use ***"); . 
10 // iextcolor(LIGHTGRA Y); // stay WHITE for dynamic data 

gotoxy( xcord, ycord); 

) 

} 



15 



wo 98/50874 



PCT/US98/09018 



216 

] 

The previous description, including the listed source code, describes the current 
preferred best mode embodiment of the invention as it is performed on personal computers 
connected through a computer network with or without a computer server. The software 
programs which are used to practice this invention typically reside in the memory and/or hard 
6 disk storage medium of the networked computers. While the current best rnode of the 

invention is used on personal computers, it is not necessary that it be limited in this way. Any 
computational device which has a long term storage medium, for example: a disk drive, a 
tape drive, a CD or optical storage medium; and can be networked to other computational 
devices. The size, configuration or purpose of the computational device does not limit the 

1 1 use of this invention to image long term stored data from one computational device to another 
in either a peer-to-peer mode or a client/server mode of operation. Furthermore, while this 
invention is performed, in its current best mode, by software written in the C programming 
language, alternative computer languages can equivalently used. The software source code 
provided as* part of the disclosure of this patent application, shows in detail how the 

1 6 functional steps of the invention are performed. Of course, it is contemplated that the 

inventive concept of this invention may be implemented through other techniques and in • 
other embodiments and in other computer languages. The computer source code is provided 
to describe the best mode of operation of the invention, such a best mode may evolve and 
change over time, after the filing of this application without altering the fundamental 

21 inventive concept of the method, which is the imaging of computer data from one computer 
to one or rnore others over a network using a peer-to-peer method and still remain compatible 
with a client/server mode of operation, without requiring special purpose network server 
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hardware. 
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Claims 

We claim: 

1. A method for imaging data between two or more digital computer systems across a 
computer network comprising: 

(A) processing a master computer for initiating the imaging of data; and 

(B) processing a slave computer for responding to the requests for data imaging 
from said master computer process. 

2. A method for imaging data between two or more digital computer systems across a 
computer network, as recited in claim 1 , wherein said processing a master computer further 
comprises: 

(1) determining the type of imaging which is desired between the 
computer systems; 

(2) transferring the image data between said slave process and said master 
process; and 

(3) broadcasting the transferred image data from a single computer system 
to more than one computer system. 

3. A method for imaging data between two or more digital computer systems across a 
computer network, as recited in claim I, wherein said processing a slave computer further 
comprises: 

(1) receiving computer system information from said master process; 

(2) transmitting said received computer system information, wherein said 
computer system information includes handshaking information, to 
said master process; 
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(3) downloading said transferred image data from said master process to 
said slave process and for storing the image data in a digital computer 
system; and 

(4) handling errors incurred in the downloading of the image data from 
said master process. 

4. A method for imaging data between two or more digital computer systems across a 
computer network, as recited in claim 2, wherein said determining the type of imaging which 
is desired between the computer systems, further comprises: 

(a) processing command line information from the systein 
• operator; and 

(b) processing menu information for gathering necessary 
information from the system operator and the digital computer 
systems. 

5. A method for imaging data between two or more digital computer systems across a 
computer network, as recited in claim 2, wherein said transferring image data between said ' 
slave process and said master process, further comprises: 

(a) opening a file containing the data to be imaged; 

(b) writing an image header for recording the image header data; 

(c) retrieving image data into a computer system; and 

(d) minimizing the data storage requirements of the retrieved 
image data. 

6. A method for imaging data between two or more digital computer systems across a 
computer network, as recited in claim 2, wherein said broadcasting the transferred image 
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(a) packaging digital computer system sector data; and • 

(b) sending said packaged digital computer system sector data 
across a network to one or more digital computer systems. 

7. A system for performing peer-to-peer imaging of information stored in a digital 
computer storage media across a digital. computer network comprising: 

(A) a first digital computer system; 

(B) a second digital computer system; 

(C) a network communication device electrically.connecting said first digital . 
computer system to said second digital computer system; and 

(D) a means for imaging data stored on said first digital computer system to said 
second digital computer system. 

8. A system for performing peer-to-peer imaging of information stored in a digital 
computer storage media across a digital computer network, as recited in claim 7, further 
comprising: 

(F) a third digital computer system; and 

(G) a means for broadcasting image data stored .on said first computer system to 
said second digital computer system and said third digital computer system. 

9. A system for performing peer-to-peer imaging of information stored in a digital 
computer storage media across a digital computer network, as recited in claim 7, further 
comprisiiig: 

(H) a means for compressing the volume of information to be imaged. 

10. A system for performing peer-to-peer imaging of information stored in a digital 
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computer storage media across a digital computer network, as recited in claim 7, wherein said 
system is operable in a client/server network environment. 

11. A system for performing peer-to-peer imaging of information stored in a digital 
computer storage media across a digital computer network, as recited in claim 7. wherein said 
system is operable in a network without electronic server hardware. 

12. Software for performing data imaging on digital computers across a computer 
network comprising: 

(A) an initialization routine to initialize variables for use by the software; 

(B) a selection routine to select the type of imaging of the digital computer data; 

(C) an upload routine to transfer digital computer data from one digital computer 
to another digital computer, wherein each digital computer operates in a peer- 
to-peer mode; 

(D) a download routine for receiving data from a digital computer to another 

digital computer; and 

(E) an error detection and reporting routine for identifying and reporting any errors 
that occur during said upload or said download routines. 



wo 98/50874 



PCTAJS98/09018 



2/15 




wo 98/50874 



PCT/US98/09018 



3/15 

MASTER START 



/ m TO LIST 

SEND ACK PACKET 
V TO SLAVE 



302 

SEND GEOMETRY ^ 
PACKET J 




DATA TO SEND 
(RESEND REQ'S ONLY) 



wo 98/50874 



PCT/US98/09018 



4/15 



SLAVE START 




DONE 



FIG. 4 



wo 98/50874 



PCT/US98/09018 



5/15 



1 



INITIALIZE 



r501 



PROCESS . 
COMMAND LINE 



-502 




■ 


l< 

r 






CLEAN-UP " 


—507 



FIG. 5 



wo 98/50874 



PCT/US98/()9018 



6/15 



_L 

INITIALIZE 



GET 
FUNCTION 



GET . 
PARTITION 



GET IMAGE 
FILE NAME 



-602 



■603 



•604 



GET BROADCAST 
• STATE 



■605 



FIG. 6 



wo 98/50874 



PCT/US98/09018 



INITIALIZE 



7/15 

-701 




OPEN IMAGE 
FILE 



WRITE IMAGE 
HEADER 



■702 



■703 







READ HEAD 


— 704 








>< 


^705 








BROADCAST 












^707 


NULL 


— ^706 


BROADCAST 

HEAD 




< 










r 


^713 








wo 98/50874 PCT/US98/0901 8 

8/15 




FIG. 8 



wo 98/50874 



PCT/US98/09018 




SEND PACKET 



-905 



FIG. 9 



wo 98/50874 



PCT/US98/09018 



10115 



i 



INITIALIZE 



-1001 



■OPEN IMAGE 
FILE 



■1002 



READ IMAGE FILE 
HEADER AND CHECK 
GEOMETRY 



-1003 




DISPLAY ERROR 
MESSAGE 



-1005 



DECOMPRESS 
DATA 



-1006 



WRITE DATA 

TO HEAD BUFFER 



-1007 



FIG. 10 



PCT/US98/09018 




FIG. 11 



wo 98/50874 



PCTAJS98/09018 



12/15 



i 




FILL COMPRESS , 
BUFFER FROM FILE 




r 


RE! 

POINTER / 


JET 

COUNTER 



-1203 



-1204 



RETURN BYTE 
POINTED TO BY 
POINTER / COUNTER 



•1206 



FIG. 12 



PCT/US98/09018 



13/15 



i. 



INITIALIZE 




r 


► 


MOVE BYTE INTO 
HEAD BUFFER 


> 


r 


INCREME 
BUFFER 


NT HEAD 
POINTER, 



■1301 



■1302 



-1303 




FILL COMPRESS 
BUFFER FROM FILE 



■NULL 



-1307 



ADJUST 
POINTERS / COUNTER 



■1305 



-1306 




FI6. 13 



wo 98/50874 



PCT/US98/09018 



14/15 




WRITE BUFFER 
TO DISK 



•1405 



ADJUST CURRENT 
HEAD & 
CYLINDER 



■1406 



FIG. 14 



wo 98/50874 



PCTAJS98/09018 



15/15 



1 



INITIALIZE 



■1501 



DISPLAY DOWNLOAD . 
C0MPLETE.ME88A6E 



•1510 



GET GEOMETRY. 
PACKET 



RETURN RSVP 



GETS RSVP 
ACK 



DOWNLOAD 



DISPLAY ERROR 
MESSAGE 



■1502 



■1503 



■1504 




•1507 



SEND UNABLE 
MESSAGE 




1509 



FIG. 15 



WORUD INTELLECTUAL PROPERTY ORGANIZATION 
International Bureau 




PCT 

INTERNATIONAL APPLICATION PUBLISHED UNDER THE PATENT COOPERATION TREATY (PCT) 



<51) International Patent Classification ^ : 
G06F 13/38, 15/17 



A3 



(11) InternaUonal Publication Number: WO 98/50874 

(43) International Publication Date: 12 November 1998 (12.1 1.98) 



(21) International Application Number: PCT/US98/09O18 

(22) International Tiling Date: ' 7 May 1998 (07.05.98) 



(30) Priority Data: 
08/854,262 



9 May 1997 (09.05.97) 



US 



(71) Applicant: KEYLABS. INC. [USAJS]; 633 South 550 East. 

Provo. UT 84606 (US). 

(72) Inventors: TURPIN, Kevin, J.; 1154 N. 660 W.. Orem, UT 

84057 (US). CLARK, Christopher, P.; 969 Pasque Drive, 
Salt Ukc City, UT 84123 (US). 

(74) Agents: SADLER, Lloyd, W. et al.; McCarthy & Sadler; LC, 
Suite 100, 39 Exchange Place, Salt Lake City, UT 84111 
(US). 



(81) Designated States: AL, AM, AT, AU, AZ, BA, BB, BG, BR, 
BY, CA. CH. CN, CU, CZ. DE, DK. EE. ES. Fl, GB, GE, 
. GH, GM, GW, HU, ID, IL. IS, JP, KE, KG, KP, KR. K2. 
LC, LK, LR. LS, LT, LU. LV. MD. MG, MK. MN, MW, 
MX, NO, NZ, PL, PT. RO, RU. SD, SE. SG, SI, SK, SL, TJ. 
TM. TR, TT, UA, UG. UZ, VN. YU, ZW, ARIPO patent 
(GH, GM, KE. LS, MW, SD, SZ, UG, ZW), Eurasian patent 
(AM, AZ, BY, KG, KZ, MD, RU, TJ, TM), European patent 
(AT, BE, CH. CY, DE. DK, ES. FI, FR, GB. GR. IE. IT, 
LU, MC. NL, PT, SE), OAPI patent (BF, BJ. CF, CG. CI, 
CM, OA. GN. ML, MR, NE, SN, TD. TO). 



Published 

With international search report. 

Be/ore the expiration of the time limit for amending the claims 
and to be republished in the event of the receipt of amendments, 

(88) Date of publication of the international search report: 

29 April 1999(29.04.99) 



(54) Title: METHOD AND SYSTEM FOR CLIENT/SERVER AND PEER-TO-PEER DISK IMAGING 




(57) Abstract 

A method and system for imaging data between two or more digital computers across a computer network is described, where the 
digital computers transfer data in a pcer-io-pcer mode and/or a clienl/servcr mode upon command of the operator. This invention addresses 
the problem of managing, updating and installing executable software, such as operating systems, utilities and application software packages 
on networked computer systems. A system operator can transfer data stored on a single computer system (101) to all or some of the computer 
systems (I02a-I02n) connected to the first system over a computer network (103) and can do so without expensive electronic server 
equipment. Moreover, this invention provides the capability of transferring data as files, sectors, or cylinders of disk media, thereby 
permitting a single operator to, through a generally automated procedure, simultaneously install new system software, configuration files and 
executive files on many computers connected in a computer networks. 



FOR THE PURPOSES OF INFORMATION ONLY 



Codes used to identify States party to the PCT on the front pages of pamphlets publishing international applications under lhe 



AL 


Albania 


ES 


Spain 


LS 


Lesotho 


SI 


Slovenia 


AM 


ArmcDia 


FI 


Finland 


LT 


Lithuania 


SK 


Slovakia 


AT 


Austria 


FR 


France 


LU 


Luxembourg 


SN 


Senegal 


AU 


Australia 


GA 


Gabon 


LV 


Latvia 


sz 


Swaziland 


AZ 


ATerbaijan 


GB 


United Kingdom 


MC 


Monaco 


TD 


Chad 


BA 


Bosnia and Herzegovina 


GE 


Georgia 


MD 


Republic of Moldova 


TG 


Togo 


BB 


Barbados 


GH 


Ghana 


MG 


Madagascar 


TJ 


Tajikistan 


BE 


Belgium 


GN 


Guinea 


MK 


The former Yugoslav 


TM 


' Tiirkmenistan 


BF 


Burkina Faso 


GR 


Greece 




Republic of Macedonia 


TR 


Turkey 


BG 


Bulgaria 


HU 


Hungary 


ML 


Mali 


TT 


Trinidad and Tobago 


BJ 


Benin 


IE 


Ireland 


MN 


Mongolia 


UA 


Ukraine. 


BR 


Brazil 


IL 


Israel 


MR 


Mauritania 


UG 


Uganda 


BY 


ill 


IS 


Iceland 


MW 


Malau^j 


US 


United States of America 


CA 


IT 


Italy 


MX 


Mexico 


uz 


Uzbekistan 


CF 


Central African Reptiblic 


JP 


japan 


NE 


Niger 


VN 


Vict Nam 
Yugoslavia 


CG 


Congo 


KE 


Kenya 


NL 


Netherlands 


YU 


CH 


Switzerland 


KG 


. Kyrgy2stan 


NO 


Norway 


• ZW 


Zimbabwe 


CI 


Cdie d'lvoiie 


KP 


Democratic People's 


NZ 


New Zealand 






CM 


Cameroon 




Republic of Korea 


. PL 


Poland 






CN 


China 


KR 


Republic of Korea 


PT • 


Portugal 






cu 


Cuba 


KZ 


Kazakstan 


RO 


Romania 






cz 


Czech Republic 


LC 


Saint Lucia 


RU 


Russian Federation 






DE 


Gcnnany 


LI 


I jechicnsicin 


SD 


Sudan 






DK 


Denmark 


LK 


Sri Lanka 


SE 


Sweden 






EE 


Estonia 


LR 


Liberia 


SG 


Singqxm 







INTERNATIONAL SEARCH REPORT 



Intemalional application No. 
PCT/US98/09O18 



A. CLASSIFICATION OF SUBJECT MATTER 

1PC(6) :G06F 13/38, 15/17 

US CL :395/200.51, 200.41, 20O.67» 200.83, 712 
According lo Inlcmational Patent Classincation (IPC) or to both 


national classification and IPC 




a FIELDS SEARCHED 


Minimum documcnUtion searched (classification system followed by- classification symbols) 
U.S. : 395/200.51, 200.41, 200.67, 200.83. 712 


DocumcnUtion searched other than minimum documentation to the extent that such documents are included in the fields searched 
NONE 


Electronic data base consulted during the inlcmational search (name of data base and, where practicable, search terms used) 
USPTOAPS 

search terms: master, slave, handshake, image, header, transfer, download, update, retrieve. daU. backup, replicate 


C DOCUMENTS CONSIDERED TO BE RELEVANT 


Category* 


Citation of document, with indication, where appropriate, of the relevant passages 


Relevant to claim No. 


X 


US 5,008,814 A (MATHUR) 16 April 1991 
Abstract; C2: 12-27; C2:50-C13:15; Fig. 1-8 


1-12 


X 


US 5,257,377 A (SATHI et ai.) 26 October 1993 
Abstract; Cl:63-C2:15; C5:42-C8:38; Fig. 5>16 


1-12 


Y 


US 5,438,671 A (MILES) 01 August 1995 

Abstract; C2:5-68; C3:37-C4:63; C5:50-C7:56; Fig. 1-3 


1-12 


Y.E 


US 5,754,863 A (REUTER) 19 May 1998 
Abstract; C2: 12-60; C3:46-C6:26; Fig. 1, 2A-2C 


1-12 


1 X Further documcnU are listed m ihc conLinuaUon of Box C. Sec patent family annex. 


* Special c»togon«> of cited docuiaenu: 

'A* document dofining th» ganera) tuu of tho art which it not con*td«r*d 
to b« of pwticulw r*tev«nca 

*E' wlioT document publtthed on or after the tnUmetionel filing dale 

*L' * docuioent which may throw doubu on priority c]aim(») or which b 
cited lo e«Ubb>b the publication data ot another ciution or other 
•p«cial reaaoQ (•« cpecined) 

*0* document referring to an oral diiclosure, uie, exhibition or other 
meaiu 

'P* document publtihed prioi U> the inUmational Tiling dale but later than 
t})a priority date claim ed 


*T' lalor document puUiabed aRer the intemational Tiling date or priori^ 
date and not in oooflict with the application but cited lo underetand 
the principle or theory underlying the invention 

*X* document of particular relevance; the cIsiiDad invention cuuiot be 
coniidered novel or cannot be considered to involve an inventive »tep 
when Ibe document is taken alone 

*Y* document of particular relevance; the claimed invention cannol be 
coDsidered to involve an inventive tlcp when the document b 
combined with one or more other »uch document*, such combination 
being obvious tx> ■ penon skilled in the art 

*&■ document member of the uune patent family 


Date of the actual completion of the international search 
28 DECEMBER 1998 


Date of mailing of the international search report 

1 1 MAR 1899: 


Name and mailing address of the ISA/US 
Conunissioner of Palcnls and Trademarks 
Box PCT 

Washington. D.C. 20231 
Facsimile No. (703) 305-3230 


Authorized officer 

MARK H. RINEHART /f y^V^'^O f(- //^i^J^^^U^ 
Telephone No. (703) 30^-9700 



Form PCT/lSA/210 (second shee4)(July 1992)* 



INTERNATIONAL SEARCH REPORT 



International application No. 
PCT/US98/09018 



C (ConlinuaUon). DOCUMENTS CONSIDERED TO BE RELEVANT 


Category* 


Citation of document, with indication, where appropriate, of the relevant passages 


Relevant to claim No. 


Y,E 


US 5,828,887 A (YEAGER et aJ.) 27 October 1998 
Abstract; Cl:58-C9:34; Fig. 1-2 


1-12 



Form PCT/1SA;210 (continuation of second sheet)(Juiy 1992)* 



PCX 



WORLD INTELLECTUAL PROPERTY ORGANIZATION 
International Bureau 




INTERNATIONAL APPLICATION PUBLISHED UNDER THE PATENT COOPERATION TREATY (PCT) 



(51) Interaational Patent Classification ^ : 
G06F 13/38, 15/17 



A3 



<11) International Publication Number: WO 98/50874 

(43) International Publication Date: 12 November 1998 (12.n.98) 



(21) International Application Number: PCT/US98/09018 

(22) International Piling Date: 7 May lSf98 (07.05.98) 



(30) Priority Data: 
08/854,262 



9 May 1997 (09.05.97) 



US 



(71) Applicant: KEYLABS, INC. [US/US]; 633 South 550 East. 

Pfovo. UT 84606 (US). 

(72) Inventors: TURPIN. Kevin, J.; 1154 N. 660 W., Orem, UT 

84057 (US). CLARK. Christopher, P.; 969 Pasque Drive, 
Salt Lake City. UT 84123 (US). 

(74) Agents: SADLER, Lloyd, W. et al.; McCarthy & Sadler. LC. 
Suite 100, 39 Exchange Place. Salt Lake City, UT 84111 
(US). 



(81) Designated States: AL. AM, AT. AU, AZ. BA. BB. BG, BR, 

BY, CA, CH. CN, CU, CZ. DE. DK, EE, ES. FI, GB. GE, 
GH, GM, GW, HU, ID, XL. IS, JP. KE, KG, KP, KR, KZ, 
LC. LK. LR, LS. LT, LU. LV. MD, MG, MK. MN. MW. 
MX, NO. NZ, PL, PT. RO, RU, SO. SE. SG, SI. SK, SL. TJ, 
TM. TR, TT, UA, UG, UZ, VN, YU. ZW, ARIPO patent 
(GH, GM, KE, LS, MW, SD, SZ, UG. ZW), Eurasian patent 
(AM, AZ, BY, KG. KZ, MD, RU, TJ. TM). European patent 
(AT, BE. CH, CY, DE, DK. ES, FI. FR, GB, GR, IE, IT. 
LU. MC. NL, PT. SE). OAPl patent (BF. BJ, CF. CG, CI. 
CM, OA, ON, ML, MR. NE, SN. TD. TG). 



Published 

With international search report. 

With amended claims. 
(88) Date of publication of the international search report: 

29 April 1999(29.04.99) 

Date of publication of the amended claims: 

29 July 1999 (2907.99) 



(54) Title: METHOD AND SYSTEM FOR CLIENT/SERVER AND PEER-TO-PEER DISK IMAGING 



□ 



-101 



1 



□ □ □ □ □ 





(57) Abstract 

A method and system for imaging data between two or more digital computers across a computer network is described, where the 
digital computers transfer data in a peer-to-peer mode and/or a client/server mode upon command of the operator. This invention addresses 
the problem of managing, updating and installing executable software, such as operating systems, utilities and application software packages 
on networked computer systems. A system operator can U-ansfer data stored on a single computer system (101) to all or some of the computer 
systems (I02a-I02n) connected to the first system over a computer network (103) and can do so without expensive electronic server 
equipment. Moreover, this invention provides the capability of transferring data as files, sectors, or cylinders of disk media, thereby 
permitting a single operator to, through a generally automated procedure, simultaneously install new system software, configuration files and 
executive files on many computers connected in a computer networks. 



FOR THE PURPOSES Of INFORMATION ONLY 



Codes used to identify States party to the PCX on the front pages of pamphlets publishing international applications under the PCT. 



AL 


Albania 


ES 


Spain 


LS 


AM 


AmicTjia 


n 


Finland 


LT 


AT 


Austria 


FR 


France 


LU 


AU 


Australia 


GA 


Gabon 


LV 


AZ 


Azeibaijan 


GB 


United Kingdcni 


MC 


BA 


Bosnia and Herzegovina 


GE 


Georgia 


MD 


BB 


Barbados 


GH 


Ghana 


MG 


BE 


Belgium 


GN 


Guinea 


MK 


BF 


' Burkina Faso . 


GR 


Greece 




EG 


Bulgaria 


HU 


Hungary 


ML 


BJ 


Benin 


!E 


Ireland 


MN 


BR 


Brazil 


IL 


Israel 


MR 


BV 


Belarus 


IS 


Iceland 


MW 


CA 


Canada 


IT 


Italy 


MX 


CF 


Central African Republic 


JP 


Japan 


NE 


CG 


Congo 


KE 


Kenya 


NL 


CH 


Switzerland . 


KG 


Kyrgyzstan 


NO 


a 


C6ie d'Jvoire 


KP 


Democrat ic People's 


NZ 


CM 


Cameroon 




Republic of Korea 


PL 


CN 


China 


KR 


Republic of Korea 


PT 


cu 


Cuba 


KZ 


Kazakstan 


RO 


cz 


Czech Republic 


LC 


Saini Lucia 


RU 


DE 


Gcimajiy 


LI 


Licchlcnsicin 


SD 


DX 


Denmaik 


LK 


Sri Lanka 


SE 


EE 


Estonia 


LR 


Liberia 


SG 



Lesotho 

Lithuania 

Luxembourg 

Latvia 

Monaco 

Republic of Moldova 

Madagascar 

The former Yugoslav 

Republic of Macedonia 

Mali 

Mongolia 

Mauritania 

Malawi 

Mexico 

Niger 

Netherlands 

Norway 

New Zealand 

Poland 

Portugal 

Romania 

Russian Federation 

Sudan 

Sweden 

Singapoie 



SI 


Slovenia 


SK 


Slovakia 


SN 


Senegal 


sz 


Swaziland 


TD 


Chad 


TG 


Togo 


TJ 


Tajikistan 


TM 


Turkmenistan 


TR 


Ttefcey 


TT ■ 


Trinidad and Tobago 


UA 


irkraine 


UG 


Uganda 


US 


United States of America 


uz 


Uzbekistan 


VN 


Viet Nam 


YU 


Yugoslavia 


ZW 


Zimbabwe 



wo 98/50874 



222 



PCTAJS98/09018 



AMENDED CLAIMS 
[received by the International Bureau on 9 May 1999 (09.05.99); 
original claims 1, 7 and 12 amended; remaining claims unchanged (3 pages)] 

1 . A method for imaging data between two or nqore digital computer systems across a 
computer network comprising: 

(A) networking a master computer to a slave computer; 

(B) processing said master computer for initiating the imaging of data; and 

(C) processing said slave computer for responding to the requests for data imaging 
from said master computer process. 

2. A method for imaging data between two or more digital computer systems across a 
computer network, as recited in claim 1, wherein said processing a master computer further 
comprises: 

( 1 ) determining the type of imaging which'is desired between the computer 
systems; 

(2) transferring the image data between said slave process and said master 
process; and 

(3) broadcasting the transferred image data from a single computer system to 
more than one computer system. 

3. A method for imaging data between two or more digital computer systems across a 
computer network, as recited in claim 1 , wherein said processing a slave computer further 
comprises: 

( 1 ) receiving computer system information from said niaster process; 

(2) transmitting said received computer system information, wherein said 
computer system information includes handshaking information, to said 
master process; 
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data, further comprises: 

(a) packaging digital computer system sector data; and 

(b) sending said packaged digital computer system sector data across a 
network to one or more digital computer systems. 

7. A system for performing peer-to-peer imaging of information stored in a digital computer 
storage medial across a digital computer network comprising: 

(A) a first digital computer system having a first disk drive; 

(B) a second digital computer system having a second disk drive; 

(C) a network communication device electrically connecting said first digital 
computer system to said second digital computer system; and 

(D) a means for simultaneously imaging data stored on said first digital computer 
system to said second digital computer system thereby duplicating all data stored 
on said first disk drive of said first digital computer system to said second disk 
drive on said second digital computer system. 

8. A system for performing peer-to-peer imaging of information stored in a digital computer 
storage media across a digital computer network, as recited in claim 7, further comprising: 

(F) a third digital computer system; and 

(G) a means for broadcasting image data stored on said first computer system to said 
second digital computer system and said third digital computer system. 

9. A system for performing peer-to-peer imaging of information stored in a digital computer 
storage media across a digital computer network, as recited in claim 7, further comprising: 

(H) a means for compressing the volume of information to be imaged. 

10. A system for performing peer-to-peer imaging of information stored in a digital 



AMENDED SHEET (ARTICLE 19) 



wo 98/50874 



224 



PCT/US98/09018 



computer storage media across a digital computer network, as recited in claim 7, wherein said 
system is operable in a client/server network environment. 

11. A system for performing peer-to-peer imaging of information stored in a digital computer 
storage media across a digital computer network, as recited in claim 7. wherein said system is 
operable in a network without electronic server hardware. 

1 2. Software for performing data imaging on digital computers across a computer network 
comprising: 

(A) an initialization routine to initialize variables for use by the software; 

(B) a selection routine to select the type of imaging of the digital computer data; 

(C) an upload routine to simultaneously transfer digital computer data from one digital 
computer to two or more other digital computers, wherein each digital computer 
operates in a peer-to-peer mode; 

(D) a download routine for receiving data from a digital computer to another digital 
computer; and 

(E) an error detection and reporting routine for identifying and reporting any errors 
that occur during said upload or said download routines. 
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